Praison AI

AI Agents framework with 64+ built-in MCP tools for search, memory, workflows, code execution, and file operations. Install via `uvx praisonai-mcp`

GitHub

Experimente este MCPPatrocinado

Documentação

PraisonAI MCP Server

Um servidor MCP que expõe agentes e ferramentas de IA do PraisonAI para uso com Claude Desktop, Cursor, VS Code, Windsurf e outros clientes MCP.

Recursos

🤖 Agentes de IA como Ferramentas - Execute agentes PraisonAI diretamente do MCP
🔄 Orquestração de Workflows - Workflows de agentes em várias etapas
🛠️ 64 Ferramentas Integradas - Cobertura completa de todos os recursos do PraisonAI
⚡ Configuração Fácil - Funciona com uvx ou pip install

Instalação

# Using uvx (Recommended)
uvx praisonai-mcp

# Using pip
pip install praisonai-mcp

Ferramentas Disponíveis (64 Total)

🤖 Ferramentas de Agentes (Principais)

As ferramentas principais para executar agentes de IA:

Ferramenta	Descrição
`run_agent`	Execute um agente PraisonAI com um prompt
`run_research`	Pesquisa aprofundada sobre qualquer tópico
`run_auto_agents`	Gere e execute agentes automaticamente para uma tarefa
`run_handoff`	Execute tarefa com transferência/delegação de agente
`generate_agents_yaml`	Gere configuração agents.yaml

🔄 Ferramentas de Workflow

Orquestre workflows de agentes em várias etapas:

Ferramenta	Descrição
`workflow_run`	Execute um workflow em várias etapas
`workflow_create`	Crie um novo workflow
`workflow_from_yaml`	Crie workflow a partir de YAML
`export_to_n8n`	Exporte workflow para o formato n8n

🌐 Ferramentas de Busca (13 ferramentas)

Busca web unificada com fallback automático entre vários provedores:

Ferramenta	Descrição
`search_web`	Busca unificada - Fallback automático entre provedores
`get_search_providers`	Liste provedores disponíveis e seus status
Tavily
`tavily_search`	Busca com IA (requer `TAVILY_API_KEY`)
`tavily_extract`	Extraia conteúdo de URLs
Exa
`exa_search`	Busca semântica (requer `EXA_API_KEY`)
`exa_search_contents`	Busca com recuperação de conteúdo completo
`exa_find_similar`	Encontre páginas semelhantes a uma URL
You.com
`ydc_search`	Busca com IA com trechos prontos para LLM (requer `YDC_API_KEY`)
`ydc_news`	Busca de notícias ao vivo
Provedores Gratuitos
`duckduckgo_search`	Busca DuckDuckGo (sem chave de API)
`wikipedia_search`	Busca na Wikipedia
`arxiv_search`	Artigos acadêmicos arXiv
`searxng_search`	Meta-busca SearxNG auto-hospedada

🕷️ Ferramentas de Crawl e Scrape

Crawling web e extração de conteúdo:

Ferramenta	Descrição
`crawl4ai_scrape`	Extraia página web usando Crawl4AI
`crawl4ai_extract`	Extraia dados estruturados com Crawl4AI
`scrape_page`	Extraia página web e extraia texto
`extract_links`	Extraia todos os links de uma página web
`web_crawl`	Crawle site e extraia conteúdo

📦 Ferramentas de Suporte

🧠 Memória e Conhecimento

Ferramenta	Descrição
`memory_add`	Adicione ao armazenamento de memória
`memory_search`	Busque memórias
`memory_list`	Liste todas as memórias
`memory_clear`	Limpe memórias
`auto_extract_memories`	Extraia memórias automaticamente de texto
`knowledge_add`	Adicione à base de conhecimento
`knowledge_search`	Busque na base de conhecimento

📋 Planejamento e Pesquisa

Ferramenta	Descrição
`plan_create`	Crie um plano para um objetivo
`plan_execute`	Execute um plano passo a passo
`deep_research`	Pesquisa aprofundada com iterações
`analyze_repository`	Analise um repositório
`fast_context_search`	Busque no código-fonte para contexto

💻 Código e Execução

Ferramenta	Descrição
`run_python`	Execute código Python
`run_shell`	Execute comandos shell
`git_commit`	Crie commits git
`code_apply_diff`	Aplique diff SEARCH/REPLACE
`code_search_replace`	Busque e substitua em arquivo

📁 Operações de Arquivo

Ferramenta	Descrição
`read_file`	Leia conteúdo de arquivo
`write_file`	Escreva conteúdo em arquivo
`list_directory`	Liste conteúdo do diretório
`read_csv`	Leia arquivo CSV
`write_csv`	Escreva arquivo CSV
`read_json_file`	Leia arquivo JSON
`write_json_file`	Escreva arquivo JSON
`read_yaml_file`	Leia arquivo YAML
`write_yaml_file`	Escreva arquivo YAML

🧮 Utilitários

Ferramenta	Descrição
`calculate`	Avalie expressões matemáticas
`get_current_time`	Obtenha data/hora atual
`solve_equation`	Resolva equações matemáticas
`convert_units`	Converta entre unidades
`calculate_statistics`	Calcule estatísticas

📈 Finanças

Ferramenta	Descrição
`get_stock_price`	Obtenha preço atual da ação
`get_stock_history`	Obtenha dados históricos de ações

🖼️ Imagem e Consulta

Ferramenta	Descrição
`analyze_image`	Analise imagem usando visão
`rewrite_query`	Reescreva consulta para melhores resultados
`expand_prompt`	Expanda prompt curto para detalhado

✅ Gerenciamento de Tarefas

Ferramenta	Descrição
`todo_add`	Adicione tarefa à lista de tarefas
`todo_list`	Liste todas as tarefas
`todo_complete`	Marque tarefa como concluída

💾 Sessão e Estado

Ferramenta	Descrição
`session_save`	Salve sessão atual
`session_load`	Carregue uma sessão salva
`session_list`	Liste todas as sessões

📜 Regras e Salvaguardas

Ferramenta	Descrição
`rules_list`	Liste todas as regras definidas
`rules_add`	Adicione uma nova regra
`rules_get`	Obtenha uma regra específica
`guardrail_validate`	Valide conteúdo contra regras

🖥️ Sistema e Telemetria

Ferramenta	Descrição
`list_processes`	Liste processos em execução
`get_system_info`	Obtenha informações do sistema
`track_metrics`	Rastreie evento de métricas
`get_metrics`	Obtenha métricas rastreadas
`select_model`	Selecione melhor modelo para tarefa

🔌 MCP e Hooks

Ferramenta	Descrição
`mcp_list_servers`	Liste servidores MCP
`mcp_connect`	Conecte-se ao servidor MCP
`hooks_list`	Liste hooks disponíveis
`docs_search`	Busque na documentação

Configurações de Cliente MCP

Claude Desktop

Arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key",
        "TAVILY_API_KEY": "your-tavily-api-key"
      }
    }
  }
}

VS Code (GitHub Copilot)

Arquivo de configuração: .vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "openai-key",
      "description": "OpenAI API Key",
      "password": true
    }
  ],
  "servers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "${input:openai-key}"
      }
    }
  }
}

Cursor

Arquivo de configuração: ~/.cursor/mcp.json

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Windsurf

Arquivo de configuração: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Cline (Extensão do VS Code)

Abra a Paleta de Comandos → "Cline: MCP Servers" → Adicione:

{
  "mcpServers": {
    "praisonai": {
      "command": "uvx",
      "args": ["praisonai-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key"
      }
    }
  }
}

Continue

Arquivo de configuração: ~/.continue/config.json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "uvx",
          "args": ["praisonai-mcp"]
        }
      }
    ]
  }
}

Zed

Arquivo de configuração: ~/.config/zed/settings.json

{
  "context_servers": {
    "praisonai": {
      "command": {
        "path": "uvx",
        "args": ["praisonai-mcp"]
      }
    }
  }
}

Claude Code (CLI)

claude mcp add praisonai -- uvx praisonai-mcp

Variáveis de Ambiente

Variável	Descrição	Necessário Para
`OPENAI_API_KEY`	Chave de API da OpenAI	Ferramentas de agente
`TAVILY_API_KEY`	Chave de API de busca Tavily	tavily_search, tavily_extract
`EXA_API_KEY`	Chave de API de busca Exa	exa_search, exa_search_contents, exa_find_similar
`YDC_API_KEY`	Chave de API do You.com	ydc_search, ydc_news
`SEARXNG_URL`	URL da instância SearxNG	searxng_search (opcional)

Executando como Servidor SSE

python -m praisonai_mcp --sse --port 8080

Licença

MIT License