Praisonai MCP

مجتمعي أدوات المطورين

AI agent framework with tools for search, memory, workflows, code execution and file operations, turning any assistant into a multi-agent system.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع Praisonai MCP؟

🤖 AI Agents as Tools - Run PraisonAI agents directly from MCP
🔄 Workflow Orchestration - Multi-step agent workflows
🛠️ 64 Built-in Tools - Complete coverage of all PraisonAI features
⚡ Easy Setup - Works with uvx or pip install

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات

PraisonAI MCP Server
Features
Installation
Available Tools (64 Total)
MCP Client Configurations
Environment Variables
Running as SSE Server
Links
License

PraisonAI MCP Server

An MCP server that exposes PraisonAI AI agents and tools for use with Claude Desktop, Cursor, VS Code, Windsurf, and other MCP clients.

Features

🤖 AI Agents as Tools - Run PraisonAI agents directly from MCP
🔄 Workflow Orchestration - Multi-step agent workflows
🛠️ 64 Built-in Tools - Complete coverage of all PraisonAI features
⚡ Easy Setup - Works with uvx or pip install

Installation

# Using uvx (Recommended)
uvx praisonai-mcp

# Using pip
pip install praisonai-mcp

Available Tools (64 Total)

🤖 Agent Tools (Primary)

The core tools for running AI agents:

Tool	Description
`run_agent`	Run a PraisonAI agent with a prompt
`run_research`	Deep research on any topic
`run_auto_agents`	Auto-generate and run agents for a task
`run_handoff`	Run task with agent handoff/delegation
`generate_agents_yaml`	Generate agents.yaml configuration

🔄 Workflow Tools

Orchestrate multi-step agent workflows:

Tool	Description
`workflow_run`	Run a multi-step workflow
`workflow_create`	Create a new workflow
`workflow_from_yaml`	Create workflow from YAML
`export_to_n8n`	Export workflow to n8n format

🌐 Search Tools (13 tools)

Unified web search with automatic fallback across multiple providers:

Tool	Description
`search_web`	Unified search - Auto-fallback across providers
`get_search_providers`	List available providers and their status
Tavily
`tavily_search`	AI-powered search (requires `TAVILY_API_KEY`)
`tavily_extract`	Extract content from URLs
Exa
`exa_search`	Semantic search (requires `EXA_API_KEY`)
`exa_search_contents`	Search with full content retrieval
`exa_find_similar`	Find similar pages to a URL
You.com
`ydc_search`	AI search with LLM-ready snippets (requires `YDC_API_KEY`)
`ydc_news`	Live news search
Free Providers
`duckduckgo_search`	DuckDuckGo search (no API key)
`wikipedia_search`	Wikipedia search
`arxiv_search`	arXiv academic papers
`searxng_search`	Self-hosted SearxNG meta search

🕷️ Crawl & Scrape Tools

Web crawling and content extraction:

Tool	Description
`crawl4ai_scrape`	Scrape webpage using Crawl4AI
`crawl4ai_extract`	Extract structured data with Crawl4AI
`scrape_page`	Scrape webpage and extract text
`extract_links`	Extract all links from a webpage
`web_crawl`	Crawl website and extract content

📦 Supporting Tools

🧠 Memory & Knowledge

Tool	Description
`memory_add`	Add to memory store
`memory_search`	Search memories
`memory_list`	List all memories
`memory_clear`	Clear memories
`auto_extract_memories`	Auto-extract memories from text
`knowledge_add`	Add to knowledge base
`knowledge_search`	Search knowledge base

📋 Planning & Research

Tool	Description
`plan_create`	Create a plan for a goal
`plan_execute`	Execute a plan step by step
`deep_research`	Deep research with iterations
`analyze_repository`	Analyze a repository
`fast_context_search`	Search codebase for context

💻 Code & Execution

Tool	Description
`run_python`	Execute Python code
`run_shell`	Execute shell commands
`git_commit`	Create git commits
`code_apply_diff`	Apply SEARCH/REPLACE diff
`code_search_replace`	Search and replace in file

📁 File Operations

Tool	Description
`read_file`	Read file contents
`write_file`	Write content to file
`list_directory`	List directory contents
`read_csv`	Read CSV file
`write_csv`	Write CSV file
`read_json_file`	Read JSON file
`write_json_file`	Write JSON file
`read_yaml_file`	Read YAML file
`write_yaml_file`	Write YAML file

🧮 Utilities

Tool	Description
`calculate`	Evaluate math expressions
`get_current_time`	Get current date/time
`solve_equation`	Solve math equations
`convert_units`	Convert between units
`calculate_statistics`	Calculate statistics

📈 Finance

Tool	Description
`get_stock_price`	Get current stock price
`get_stock_history`	Get historical stock data

🖼️ Image & Query

Tool	Description
`analyze_image`	Analyze image using vision
`rewrite_query`	Rewrite query for better results
`expand_prompt`	Expand short prompt to detailed

✅ Task Management

Tool	Description
`todo_add`	Add task to todo list
`todo_list`	List all tasks
`todo_complete`	Mark task as completed

💾 Session & State

Tool	Description
`session_save`	Save current session
`session_load`	Load a saved session
`session_list`	List all sessions

📜 Rules & Guardrails

Tool	Description
`rules_list`	List all defined rules
`rules_add`	Add a new rule
`rules_get`	Get a specific rule
`guardrail_validate`	Validate content against rules

🖥️ System & Telemetry

Tool	Description
`list_processes`	List running processes
`get_system_info`	Get system information
`track_metrics`	Track metrics event
`get_metrics`	Get tracked metrics
`select_model`	Select best model for task

🔌 MCP & Hooks

Tool	Description
`mcp_list_servers`	List MCP servers
`mcp_connect`	Connect to MCP server
`hooks_list`	List available hooks
`docs_search`	Search documentation

MCP Client Configurations

Claude Desktop

Config file: ~/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)

Config file: .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

Config file: ~/.cursor/mcp.json

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

Windsurf

Config file: ~/.codeium/windsurf/mcp_config.json

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

Cline (VS Code Extension)

Open Command Palette → "Cline: MCP Servers" → Add:

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

Continue

Config file: ~/.continue/config.json

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

Zed

Config file: ~/.config/zed/settings.json

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

Claude Code (CLI)

claude mcp add praisonai -- uvx praisonai-mcp

Environment Variables

Variable	Description	Required For
`OPENAI_API_KEY`	OpenAI API key	Agent tools
`TAVILY_API_KEY`	Tavily search API key	tavily_search, tavily_extract
`EXA_API_KEY`	Exa search API key	exa_search, exa_search_contents, exa_find_similar
`YDC_API_KEY`	You.com API key	ydc_search, ydc_news
`SEARXNG_URL`	SearxNG instance URL	searxng_search (optional)

Running as SSE Server

python -m praisonai_mcp --sse --port 8080

License

MIT License

الأسئلة الشائعة

ما هو Praisonai MCP؟