MCPAdapt

MCPAdapt

如需了解更多背景信息、指南和 API 参考，请访问我们的新版文档。

在你喜欢的 Agent 框架中解锁 650 多个 MCP 服务的工具。

Model Context Protocol 是 Anthropic 推出的开源协议，让任何人都能轻松、快速地将工具和资源作为“MCP 服务”提供出来。

自发布以来，已有 650 多个 MCP 服务诞生，为受支持的“MCP 客户端”提供了对大量数据和工具的访问权限。

本项目让你能够在任何 Agent 框架中无缝调用任意 MCP 服务的工具，几乎可以让你的 Agent 工作流访问 650 多个 MCP 服务的工具。

访问 glama.ai 或 smithery.ai，了解你的 Agent 可以访问哪些内容。

安装说明

Smolagents

Smolagents 1.4.1 及更高版本已在其工具集合对象中直接集成 mcpadapt。 这意味着你可以直接在 smolagents 中使用它：

uv add smolagents[mcp]

其他框架

每个 Agent 框架都有自己的一组可选依赖项，以免引入不必要的依赖。 在安装命令中将框架名放在方括号内，即可选择所需版本。

# with uv
uv add mcpadapt[langchain]

# or with pip
pip install mcpadapt[langchain]

目前支持的框架：smolagents、langchain、crewAI、google-genai。

如有需要，也可以用逗号分隔，添加多个框架。

用法

⚠️ 安全警告：使用 MCP 服务时，尤其是通过 SSE（Server-Sent Events）连接时，务必格外谨慎，只连接可信且经过验证的服务。连接前，请始终核实 MCP 服务的来源和安全性。

Smolagents

由于 mcpadapt 已集成到 smolagents 中，只需像下面这样使用 smolagents 的工具集合：

from mcp import StdioServerParameters
from smolagents.tools import ToolCollection

serverparams = StdioServerParameters(command="uv", args=["run", "src/echo.py"])

with ToolCollection.from_mcp(serverparams) as tool_collection:
    ... # enjoy your tools!

其他框架

MCPAdapt 可将任意 MCP 服务适配为工具，供你直接在 Agent 工作流中使用：

from mcp import StdioServerParameters
from mcpadapt.core import MCPAdapt
from mcpadapt.smolagents_adapter import SmolAgentsAdapter

with MCPAdapt(
    # specify the command to run your favorite MCP server (support also smithery and co.)
    StdioServerParameters(command="uv", args=["run", "src/echo.py"]),
    # or a dict of sse server parameters e.g. {"url": http://localhost:8000, "headers": ...}

    # specify the adapter you want to use to adapt MCP into your tool in this case smolagents.
    SmolAgentsAdapter(),
) as tools:
    # enjoy your smolagents tools as if you wrote them yourself
    ...

MCP Adapt 支持 Smolagents、Langchain、CrewAI、google-genai [pydantic.dev、Llammaindex 等]。 *即将推出。

注意：你也可以像这样指定多个 MCP 服务：

from mcp import StdioServerParameters
from mcpadapt.core import MCPAdapt
from mcpadapt.smolagents_adapter import SmolAgentsAdapter

with MCPAdapt(
    [
        StdioServerParameters(command="uv", args=["run", "src/echo1.py"]),
        StdioServerParameters(command="uv", args=["run", "src/echo2.py"]),
    ],
    SmolAgentsAdapter(),
) as tools:
    # tools is now a flattened list of tools from the 2 MCP servers.
    ...

如果底层 Agent 框架支持异步，我们也支持异步。

有关用法的更多详情，请参阅我们的示例。

参与贡献

如果缺少你喜欢的 Agent 框架，也没关系，你可以自行添加，过程非常简单：

1. 在 src/mcpadapt/{name_of_your_framework}_adapter.py 中创建一个新模块：

class YourFrameworkAdapter(ToolAdapter):
    def adapt(
        self,
        func: Callable[[dict | None], mcp.types.CallToolResult],
        mcp_tool: mcp.types.Tool,
    ) -> YourFramework.Tool:
        # HERE implement how the adapter should convert a simple function and mcp_tool (JSON Schema)
        # into your framework tool. see smolagents_adapter.py for an example
    
    def async_adapt(
        self,
        afunc: Callable[[dict | None], Coroutine[Any, Any, mcp.types.CallToolResult]],
        mcp_tool: mcp.types.Tool,
    ) -> YourFramework.Tool:
        # if your framework supports async function even better use async_adapt.

2. 就这样，测试你的适配器是否正常工作，然后向我们提交 PR，与大家分享。

路线图

• 初始框架，供任何人开始创建适配器
• 支持 smolagents
• 支持 pydantic-ai
• 支持 langchain
• 支持 llamaindex
• 支持 swarm
• 支持 crewAI
• 支持 google genai
• 支持通过 SSE 使用远程 MCP 服务
• 支持 jupyter notebook
• 添加测试

贡献者

我们感谢所有贡献者和维护者所做的工作及贡献。

核心维护者：

• @grll

贡献者：

• @murawakimitsuhiro
• @joejoe2
• @tisDDM
• @sysradium