automcp

automcp

site icon
2025.04.18 171
Python代理框架转换MCP服务器部署开发效率
automcp 是一个工具,能够将现有的代理框架(如CrewAI、LangGraph等)转换为符合MCP(Model Context Protocol)标准的服务器,从而通过标准化接口被客户端(如Cursor和Claude Desktop)访问。其主要功能包括支持多种代理框架的转换、提供STDIO和SSE两种传输模式、以及简化MCP服务器的创建和部署过程。
View on GitHub

Overview

基本能力

产品定位

automcp 旨在简化代理框架到MCP服务器的转换过程,使开发者能够快速部署符合MCP标准的服务,便于客户端通过标准化接口进行访问。

核心功能

  1. 多框架支持:支持CrewAI、LangGraph、Llama Index、OpenAI Agents SDK、Pydantic AI和mcp-agent等多种代理框架的转换。
  2. 传输模式:提供STDIO和SSE两种传输模式,适应不同客户端需求。
  3. 快速部署:通过CLI工具快速生成MCP服务器文件,简化部署流程。
  4. 适配器创建:支持自定义适配器,扩展对新框架的支持。

适用场景

  1. 代理服务部署:将现有的代理服务快速转换为MCP服务器,便于客户端集成。
  2. 开发调试:在开发过程中快速测试代理服务的MCP兼容性。
  3. 多客户端支持:通过标准化接口支持多种客户端(如Cursor、Claude Desktop)访问。

工具列表

  1. automcp CLI:用于初始化、配置和运行MCP服务器的命令行工具。
  2. MCP Inspector:用于调试MCP服务器的工具。

常见问题解答

  1. STDIO模式注意事项:避免在代理代码中使用打印语句,以免破坏协议。
  2. SSE模式部署:需要手动启动服务器并配置客户端连接。
  3. 环境变量配置:确保在部署时正确配置所需的环境变量(如OPENAI_API_KEY)。

使用教程

使用依赖

安装automcp前需确保已安装Python和pip或uv。

安装教程

  1. 从PyPI安装bash pip install naptha-automcp 或使用uv: bash uv add naptha-automcp
  2. 从源码安装bash git clone https://github.com/napthaai/automcp.git cd automcp uv venv source .venv/bin/activate pip install -e .

调试方式

  1. 初始化MCP服务器bash automcp init -f crewai
  2. 编辑配置文件:修改生成的run_mcp.py文件,配置代理服务和输入模式。
  3. 运行服务器
  4. STDIO模式: bash automcp serve -t stdio
  5. SSE模式: bash automcp serve -t sse
  6. 调试工具:使用MCP Inspector进行调试: bash npx @modelcontextprotocol/inspector

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。