MCP代理连接器

MCP代理连接器是一个开源库,用于自动发现MCP服务器并同步其功能,支持多种代理平台和实时同步。

  • by Sumedh1599
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sumedh1599/mcp_agent_connector

使用说明

MCP代理连接器

引言

这 MCP代理连接器 是一个强大的开源库,旨在使任何符合MCP的代理平台(如Claude、Grok、TypingMind、Cursor等)能够自动发现生成的MCP服务器,并直接从构建元数据中同步功能。该库通过自动化MCP服务器的发现并确保与客户端环境的实时同步,简化了集成过程。

特性

  • 自动发布MCP服务器清单:自动发布MCP服务器上可用的工具和资源清单。
  • 支持mcp代理和Lutra代理:两者兼容 mcp-agent 和 Lutra 代理平台,提供灵活的集成选项。
  • 通过本地网络广播元数据(可选):可选地通过本地网络广播元数据,以方便兼容代理的自动发现。
  • 通过Claude Desktop配置进行Claude代理映射:使用Claude Desktop的配置映射Claude代理,实现无缝集成。
  • 与客户端环境实时同步:确保客户端环境与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代理映射的自定义配置

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代理连接器。
    • 参数:
      • claude_config:(可选)的实例 ClaudeConfig 用于克劳德代理映射。
      • broadcast_config:(可选)的实例 BroadcastConfig 以允许通过本地网络进行元数据广播。
  • start(self)

    • 启动自动发布过程和任何其他配置的功能,如Claude代理映射或元数据广播。

类别: ClaudeConfig

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

类别: BroadcastConfig

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

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 文件以获取详细信息。


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

⚠️ 开发状态

这个图书馆目前处于早期开发阶段。某些测试可能因以下问题而失败:


欢迎为解决这些问题做出贡献!如果您有解决方案,请提交拉取请求。