代理MCP服务器

Master-MCP是一个轻量级的代理MCP服务器,用于连接多个MCP服务器并通过单一端点重新导出其工具,适用于代理工作流中的工具管理。

  • by MarvinRomson
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 MarvinRomson/master-mcp

使用说明

主MCP

一个MCP端点。你所有的工具。完全可编辑。

主MCP是一个轻量级的 代理MCP服务器 它连接到多个MCP服务器,并通过 单MCP端点.

它专为代理工作流程而设计,在这些工作流程中,工具目录可能会变得庞大、混乱且难以管理。

为什么要掌握MCP

  • 统一MCP:插入许多MCP服务器,公开一个工具列表。
  • 命名空间:工具会自动重命名为 <server>-<tool>.
  • 模式编辑器UI:编辑工具描述/参数、隐藏工具和整理目录。
  • 搜索MCP(可选):regex+BM25搜索工具。
  • CodeExec支持:为Python/TypeScript生成代码友好的包装器。

快速开始

pip install -r requirements.txt
python master_mcp_client.py

然后打开模式编辑器:

open http://127.0.0.1:8001/

使用代理运行主MCP

作为stdio MCP服务器

在代理中使用MCP配置(如果不在根目录中,请使用master_MCP_client.py的路径):

{
  "master-mcp": {
        "command": "python",
        "args": ["master_mcp_client.py"]
  }
}

通过以下方式使用HTTP传输 mcp代理

npx mcp-proxy \
  --port 3333 \
  python master_mcp_client.py

文档

  • 完整的文档和架构:参见 FULL_README.md
  • 在中配置外部MCP mcps.json

链接

  • 博客文章:https://towardsdatascience.com/master-mcp-as-a-way-to-keep-mcps-useful-in-agentic-pipelines/
  • MCP Python SDK:https://github.com/modelcontextprotocol/python-sdk

路线图/想法

  • 代码执行模式(不同语言集成)
  • 可视化UI,用于在运行时启用/禁用工具和MCP
  • 高级安全模型(用户角色、沙盒、显式确认)
  • 除了stdio之外,还可以选择HTTP/WebSocket传输
  • 监控工具
  • 工具层次结构机制
  • 工具编排
  • 添加技能和提示(只是一个没有工具执行的提示)

🤝 贡献与协作

如果您有兴趣贡献、测试新的检测方法或探索相关项目,请随时贡献并联系我——欢迎合作!

📩 联系人:marvinromson@gmail.com 和 领英


❤️ 支持

如果你觉得这个项目有帮助或在你的研究中使用它,你可以支持进一步的发展:
📩 联系人:marvinromson@gmail.com