CrewAI MCP 适配器

一个 Python 库，扩展了 CrewAI 的适配器生态系统，并集成了 模型上下文协议 (MCP) 支持以及针对自定义代理和工具开发的全面工具。

功能特性

• 🔌 与 CrewAI 的原生集成及适配器模式
• 🛠️ MCP 协议支持，实现工具集成
• 🧩 扩展和创建新适配器的易用接口
• 📝 使用 Pydantic 的类型安全实现
• 🔍 工具参数的 JSON Schema 验证
• 🚀 异步/等待支持
• 📊 详细的执行元数据

安装

可以直接从 PyPI 安装：

pip install crewai-adapters

或者从源代码安装：

pip install git+https://github.com/dshivendra/crewai_mcp_adapter.git

快速上手

from crewai import Agent, Task
from crewai_adapters import CrewAIAdapterClient
from crewai_adapters.types import AdapterConfig

async def main():
    async with CrewAIAdapterClient() as client:
        # 连接到 MCP 服务器
        await client.connect_to_mcp_server(
            "math",
            command="python",
            args=["math_server.py"]
        )

        # 创建代理及其工具
        agent = Agent(
            name="Calculator",
            goal="执行计算操作",
            tools=client.get_tools()
        )

        # 执行任务
        task = Task(
            description="计算 (3 + 5) × 12",
            agent=agent
        )
        result = await task.execute()
        print(f"结果: {result}")

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

文档

详细文档请参考：

• 入门指南
• API 参考
• 示例

开发

先决条件

• Python 3.11 或更高版本
• crewai 包
• pydantic 包
• mcp 包

安装开发依赖项

pip install -e ".[test,docs]"

运行测试

pytest tests/ -v

发布

要发布新版本到 PyPI：

1. 更新 pyproject.toml 中的版本号
2. 构建包：

   python -m build
   

3. 上传到 PyPI：

   python -m twine upload dist/*
   

许可证

本项目使用 MIT 许可证，详情请查看 LICENSE 文件。

贡献

欢迎贡献！请随意提交 Pull Request。