CAMEL Toolkits MCP

一个轻量级服务器，将CAMEL框架工具包导出为与MCP兼容的工具。

概述

该项目弥合了CAMEL AI框架工具包生态系统与MCP（模型控制协议）兼容客户端之间的差距。它允许您动态加载并暴露任何Camel工具包作为MCP服务器，使这些工具可用于各种基于LLM的应用程序。

关键特性：

• 动态发现并列出可用的CAMEL工具包
• 在运行时加载并执行工具包函数
• 将CAMEL工具包函数无缝转换为与MCP兼容的工具

安装

您可以直接从PyPI安装该包：

pip install camel-toolkits-mcp

或者从源代码安装：

git clone https://github.com/jinx0a/camel-toolkits-mcpgit
cd camel-toolkits-mcp
pip install -e .

配置MCP客户端

使用uvx配置

您可以轻松地配置uvx以运行CAMEL工具包服务器，如下所示：

{
  "mcpServers": {
    "camel-toolkits": {
      "command": "uvx",
      "args": [
        "camel-toolkits-mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-key",
        "NOTION_TOKEN": "your-notion-token",
        "..." : "..."
      }
    }
  }
}

本地开发配置

如果您正在本地开发此包，可以配置UVX使用您的开发版本：

{
  "mcpServers": {
    "camel_toolkits_mcp": {
      "command": "/path/to/python",
      "args": [
        "/path/to/camel_toolkits_mcp/server.py"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-key",
        "NOTION_TOKEN": "your-notion-token",
        "..." : "..."
      }
    }
  }
}

可用工具

服务器公开以下与MCP兼容的工具：

• get_toolkits_list(): 列出所有可用的CAMEL工具包及其描述
• list_toolkit_functions(toolkit_name, include_methods=True): 列出特定工具包中的所有可用函数
• execute_toolkit_function(toolkit_name, function_name, toolkit_params=None, function_args=None): 执行来自特定工具包的特定函数

示例：使用工具

# 首先，发现可用的工具包
toolkits = get_toolkits_list()
print(toolkits)  # 显示所有可用的工具包

# 列出特定工具包中的函数（例如，NotionToolkit）
functions = list_toolkit_functions(toolkit_name="NotionToolkit")

# 执行工具包函数
result = execute_toolkit_function(
    toolkit_name="NotionToolkit",
    function_name="search_pages",
    toolkit_params={"notion_token": "your-notion-token"},
    function_args={"query": "会议记录"}
)

架构

路由器的工作原理是：

1. 扫描CAMEL框架的工具包目录
2. 分析每个工具包类以检测其工具和API需求
3. 为每个工具函数创建适当的MCP兼容包装器
4. 通过FastMCP服务器公开这些函数

支持的工具包

此服务器支持CAMEL框架中的所有工具包，包括：

• NotionToolkit
• OpenAIToolkit
• WebSearchToolkit
• 以及更多...

API密钥管理

对于需要API密钥的工具包（如Notion、OpenAI等），在配置MCP服务器时应提供它们的环境变量。

开发

要设置开发环境：

pip install -e ".[dev]"

运行测试：

pytest

贡献

欢迎贡献！该项目使用GitHub Actions进行CI/CD：

1. 在拉取请求时自动运行测试
2. 创建GitHub发布时自动将新版本发布到PyPI

许可证

本项目根据MIT许可证授权 - 查看LICENSE文件了解详细信息。