MCP Agent Connector

MCP Agent Connector

简介

MCP Agent Connector 是一个功能强大的开源库，旨在让任何兼容 MCP 的 Agent 平台（例如 Claude、Grok、TypingMind、Cursor 等）都能自动发现生成的 MCP 服务，并直接从构建元数据同步功能。该库通过自动发现 MCP 服务，并确保与客户端环境实时同步，简化了集成流程。

功能

• 自动发布 MCP 服务清单：自动发布 MCP 服务上可用的工具和资源清单。
• 支持 mcp-agent 和 Lutra Agent：兼容 mcp-agent 和 Lutra Agent 平台，提供灵活的集成选项。
• 通过本地网络广播元数据（可选）：可选通过本地网络广播元数据，便于兼容的 Agent 自动发现。
• 通过 Claude Desktop 配置映射 Claude Agent：使用 Claude Desktop 的配置映射 Claude Agent，实现无缝集成。
• 与客户端环境实时同步：确保客户端环境始终具有来自 MCP 服务的最新功能和信息。

安装说明

要安装 mcp_agent_connector 库，可以使用 pip：

pip install mcp-agent-connector

或者，如果你更愿意克隆代码库并手动安装，请按以下步骤操作：

1. 克隆代码库：

   git clone https://github.com/your-username/mcp_agent_connector.git
   

2. 进入项目目录：

   cd mcp_agent_connector
   

3. 使用 pip 安装库：

   pip install .
   

使用示例

示例 1：基本初始化和自动发布

from mcp_agent_connector import MCPAgentConnector

# Initialize the connector with default settings
connector = MCPAgentConnector()

# Start auto-publishing the MCP server manifest
connector.start()

示例 2：为 Claude Agent 映射自定义配置

from mcp_agent_connector import MCPAgentConnector, ClaudeConfig

# Define custom configuration for Claude agents
claude_config = ClaudeConfig(
    desktop_path="/path/to/claude/desktop/config",
    agent_mapping={"agent1": "server1", "agent2": "server2"}
)

# Initialize the connector with the custom configuration
connector = MCPAgentConnector(claude_config=claude_config)

# Start auto-publishing and mapping Claude agents
connector.start()

示例 3：启用通过本地网络广播元数据

from mcp_agent_connector import MCPAgentConnector, BroadcastConfig

# Define broadcast configuration
broadcast_config = BroadcastConfig(
    enabled=True,
    network_interface="eth0",
    broadcast_interval=60  # seconds
)

# Initialize the connector with broadcast configuration
connector = MCPAgentConnector(broadcast_config=broadcast_config)

# Start broadcasting and auto-publishing
connector.start()

API 文档

类：MCPAgentConnector

• __init__(self, claude_config=None, broadcast_config=None)

  • 初始化 MCP Agent Connector。
  • 参数：
    • claude_config：（可选）用于映射 Claude Agent 的 ClaudeConfig 实例。
    • broadcast_config：（可选）用于启用通过本地网络广播元数据的 BroadcastConfig 实例。

• start(self)

  • 启动自动发布流程，以及 Claude Agent 映射或元数据广播等任何其他已配置的功能。

类：ClaudeConfig

• __init__(self, desktop_path=None, agent_mapping=None)
  • 初始化 Claude Agent 的配置。
  • 参数：
    • desktop_path：（可选）Claude Desktop 配置文件的路径。
    • agent_mapping：（可选）将 Claude Agent 名称映射到 MCP 服务名称的字典。

类：BroadcastConfig

• __init__(self, enabled=False, network_interface=None, broadcast_interval=30)
  • 初始化本地网络元数据广播配置。
  • 参数：
    • enabled：（默认值：False）用于指示是否启用广播的布尔值。
    • network_interface：（可选）用于广播的网络接口。
    • broadcast_interval：（默认值：30 秒）广播间隔。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

---

欢迎通过提交拉取请求或在 GitHub 上报告问题，为这个开源库做出贡献。我们欢迎任何反馈和建议，以改进 mcp_agent_connector！

⚠️ 开发状态

该库目前处于早期开发阶段。某些测试可能会因以下问题而失败：

欢迎提交贡献来修复这些问题！如果你有解决方案，请提交拉取请求。