mcp-connector

MCP Connector

连接到任意 MCP（模型上下文协议）服务，并与其工具、资源和提示词交互。

支持的传输方式

• stdio — 将本地 MCP 服务作为子进程启动（例如 npx @modelcontextprotocol/server-filesystem /path）
• sse — 通过 HTTP Server-Sent Events 连接到远程 MCP 服务
• streamable-http — 通过较新的可流式 HTTP 传输方式连接（使用 POST 并返回 SSE 响应）

使用流程

1. 使用 mcp_browse 浏览可用服务（或按类别筛选）
2. 从注册表按名称连接：mcp_connect(name="coingecko")
3. 使用 mcp_list_tools 或 mcp_list_resources 发现可用工具和资源
4. 通过 mcp_call_tool 或 mcp_read_resource 使用它们
5. 完成后使用 mcp_disconnect 断开连接

预配置注册表

我们在 config/mcp_servers.yaml 中维护了一份精选的 MCP 服务列表。按名称连接其中任意服务即可，无需提供 URL 或传输方式详情：

mcp_connect(name="coingecko")     # Crypto market data
mcp_connect(name="exa")           # Neural web search
mcp_connect(name="dexpaprika")    # DEX data across chains

使用 mcp_browse() 查看所有可用服务，或按类别筛选：

mcp_browse(category="blockchain")
mcp_browse(category="developer")

某些服务需要环境变量（API 密钥）。工具会告知缺少哪些变量。

临时连接

你仍然可以通过提供传输方式详情，连接注册表中没有的任意 MCP 服务：

stdio（本地子进程）

mcp_connect(
    name="fs",
    transport="stdio",
    command="npx",
    args=["-y", "@modelcontextprotocol/server-filesystem", "/workspace"]
)

SSE（HTTP Server-Sent Events）

mcp_connect(
    name="remote-tools",
    transport="sse",
    url="https://mcp.example.com/sse"
)

Streamable HTTP

mcp_connect(
    name="api-server",
    transport="streamable-http",
    url="https://mcp.example.com/mcp"
)

使用已连接的服务

调用工具

mcp_call_tool(
    server="coingecko",
    tool="get_price",
    arguments={"coin": "bitcoin"}
)

读取资源

mcp_read_resource(
    server="remote-tools",
    uri="file:///data/config.json"
)

注意事项

• 连接会在整个会话期间保持
• 可以同时连接多个服务
• 服务名称必须唯一——使用相同名称重新连接会替换旧连接
• 可以通过 env 参数向 stdio 服务传递环境变量
• 注册表条目位于 config/mcp_servers.yaml 中——可在其中添加新服务（无需修改代码）