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

Prueba este MCPPatrocinado

Documentación

Servidor MCP de PraisonAI

Un servidor MCP que expone los agentes y herramientas de IA de PraisonAI para usarlos con Claude Desktop, Cursor, VS Code, Windsurf y otros clientes MCP.

Características

🤖 Agentes de IA como Herramientas - Ejecuta agentes de PraisonAI directamente desde MCP
🔄 Orquestación de Flujos de Trabajo - Flujos de trabajo de agentes en múltiples pasos
🛠️ 64 Herramientas Integradas - Cobertura completa de todas las funciones de PraisonAI
⚡ Configuración Sencilla - Funciona con uvx o pip install

Instalación

# Using uvx (Recommended)
uvx praisonai-mcp

# Using pip
pip install praisonai-mcp

Herramientas Disponibles (64 en Total)

🤖 Herramientas de Agente (Principales)

Las herramientas principales para ejecutar agentes de IA:

Herramienta	Descripción
`run_agent`	Ejecuta un agente de PraisonAI con un prompt
`run_research`	Investigación profunda sobre cualquier tema
`run_auto_agents`	Genera y ejecuta agentes automáticamente para una tarea
`run_handoff`	Ejecuta tarea con transferencia/delegación de agentes
`generate_agents_yaml`	Genera configuración de agents.yaml

🔄 Herramientas de Flujo de Trabajo

Orquesta flujos de trabajo de agentes en múltiples pasos:

Herramienta	Descripción
`workflow_run`	Ejecuta un flujo de trabajo en múltiples pasos
`workflow_create`	Crea un nuevo flujo de trabajo
`workflow_from_yaml`	Crea flujo de trabajo desde YAML
`export_to_n8n`	Exporta flujo de trabajo a formato n8n

🌐 Herramientas de Búsqueda (13 herramientas)

Búsqueda web unificada con respaldo automático entre múltiples proveedores:

Herramienta	Descripción
`search_web`	Búsqueda unificada - Respaldo automático entre proveedores
`get_search_providers`	Lista los proveedores disponibles y su estado
Tavily
`tavily_search`	Búsqueda impulsada por IA (requiere `TAVILY_API_KEY`)
`tavily_extract`	Extrae contenido de URLs
Exa
`exa_search`	Búsqueda semántica (requiere `EXA_API_KEY`)
`exa_search_contents`	Búsqueda con recuperación de contenido completo
`exa_find_similar`	Encuentra páginas similares a una URL
You.com
`ydc_search`	Búsqueda de IA con fragmentos listos para LLM (requiere `YDC_API_KEY`)
`ydc_news`	Búsqueda de noticias en vivo
Proveedores Gratuitos
`duckduckgo_search`	Búsqueda DuckDuckGo (sin clave API)
`wikipedia_search`	Búsqueda en Wikipedia
`arxiv_search`	Artículos académicos de arXiv
`searxng_search`	Metabúsqueda SearxNG autoalojada

🕷️ Herramientas de Rastreo y Extracción

Rastreo web y extracción de contenido:

Herramienta	Descripción
`crawl4ai_scrape`	Extrae página web usando Crawl4AI
`crawl4ai_extract`	Extrae datos estructurados con Crawl4AI
`scrape_page`	Extrae página web y extrae texto
`extract_links`	Extrae todos los enlaces de una página web
`web_crawl`	Rastrea sitio web y extrae contenido

📦 Herramientas de Soporte

🧠 Memoria y Conocimiento

Herramienta	Descripción
`memory_add`	Añade al almacén de memoria
`memory_search`	Busca memorias
`memory_list`	Lista todas las memorias
`memory_clear`	Borra memorias
`auto_extract_memories`	Extrae memorias automáticamente del texto
`knowledge_add`	Añade a la base de conocimiento
`knowledge_search`	Busca en la base de conocimiento

📋 Planificación e Investigación

Herramienta	Descripción
`plan_create`	Crea un plan para un objetivo
`plan_execute`	Ejecuta un plan paso a paso
`deep_research`	Investigación profunda con iteraciones
`analyze_repository`	Analiza un repositorio
`fast_context_search`	Busca en el código fuente para contexto

💻 Código y Ejecución

Herramienta	Descripción
`run_python`	Ejecuta código Python
`run_shell`	Ejecuta comandos de shell
`git_commit`	Crea commits de git
`code_apply_diff`	Aplica diff de BUSCAR/REEMPLAZAR
`code_search_replace`	Busca y reemplaza en archivo

📁 Operaciones de Archivos

Herramienta	Descripción
`read_file`	Lee contenido de archivos
`write_file`	Escribe contenido en archivo
`list_directory`	Lista contenido de directorio
`read_csv`	Lee archivo CSV
`write_csv`	Escribe archivo CSV
`read_json_file`	Lee archivo JSON
`write_json_file`	Escribe archivo JSON
`read_yaml_file`	Lee archivo YAML
`write_yaml_file`	Escribe archivo YAML

🧮 Utilidades

Herramienta	Descripción
`calculate`	Evalúa expresiones matemáticas
`get_current_time`	Obtiene fecha/hora actual
`solve_equation`	Resuelve ecuaciones matemáticas
`convert_units`	Convierte entre unidades
`calculate_statistics`	Calcula estadísticas

📈 Finanzas

Herramienta	Descripción
`get_stock_price`	Obtiene precio actual de acciones
`get_stock_history`	Obtiene datos históricos de acciones

🖼️ Imagen y Consulta

Herramienta	Descripción
`analyze_image`	Analiza imagen usando visión
`rewrite_query`	Reescribe consulta para mejores resultados
`expand_prompt`	Expande prompt corto a detallado

✅ Gestión de Tareas

Herramienta	Descripción
`todo_add`	Añade tarea a lista de pendientes
`todo_list`	Lista todas las tareas
`todo_complete`	Marca tarea como completada

💾 Sesión y Estado

Herramienta	Descripción
`session_save`	Guarda sesión actual
`session_load`	Carga una sesión guardada
`session_list`	Lista todas las sesiones

📜 Reglas y Salvaguardas

Herramienta	Descripción
`rules_list`	Lista todas las reglas definidas
`rules_add`	Añade una nueva regla
`rules_get`	Obtiene una regla específica
`guardrail_validate`	Valida contenido contra reglas

🖥️ Sistema y Telemetría

Herramienta	Descripción
`list_processes`	Lista procesos en ejecución
`get_system_info`	Obtiene información del sistema
`track_metrics`	Registra evento de métricas
`get_metrics`	Obtiene métricas registradas
`select_model`	Selecciona el mejor modelo para la tarea

🔌 MCP y Hooks

Herramienta	Descripción
`mcp_list_servers`	Lista servidores MCP
`mcp_connect`	Conecta a servidor MCP
`hooks_list`	Lista hooks disponibles
`docs_search`	Busca documentación

Configuraciones de Cliente MCP

Claude Desktop

Archivo de configuración: ~/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)

Archivo de configuración: .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

Archivo de configuración: ~/.cursor/mcp.json

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

Windsurf

Archivo de configuración: ~/.codeium/windsurf/mcp_config.json

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

Cline (Extensión de VS Code)

Abre la Paleta de Comandos → "Cline: MCP Servers" → Añadir:

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

Continue

Archivo de configuración: ~/.continue/config.json

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

Zed

Archivo de configuración: ~/.config/zed/settings.json

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

Claude Code (CLI)

claude mcp add praisonai -- uvx praisonai-mcp

Variables de Entorno

Variable	Descripción	Requerida Para
`OPENAI_API_KEY`	Clave API de OpenAI	Herramientas de agente
`TAVILY_API_KEY`	Clave API de búsqueda Tavily	tavily_search, tavily_extract
`EXA_API_KEY`	Clave API de búsqueda Exa	exa_search, exa_search_contents, exa_find_similar
`YDC_API_KEY`	Clave API de You.com	ydc_search, ydc_news
`SEARXNG_URL`	URL de instancia SearxNG	searxng_search (opcional)

Ejecución como Servidor SSE

python -m praisonai_mcp --sse --port 8080

Enlaces

Licencia

Licencia MIT