Orchestration MCP 服务器集成与网关

使用说明(简要指南,便于快速上手):

  • 项目简介
    • 该仓库实现了一套基于 Model Context Protocol (MCP) 的后端架构,核心职责是向 LLM 客户端提供可管控的上下文信息与功能,包括资源管理、工具注册与执行、以及提示模板渲染等。
    • 主要组件包括:ZEN Coordinator( MCP 服务网关/协调器)、各类核心 MCP 服务(Filesystem、Git、Memory、Database、Memory、Transcriber、Research 等)、以及围绕 MCP 的 wrapper/路由与监控模块。
  • 主要功能点
    • MCP 协议支持与路由:通过 JSON-RPC 风格的请求/响应进行工具调用、资源访问与服务发现,支持单请求路由、批量调用以及工具发现。
    • 资源、工具与提示管理:提供资源访问、工具调用、以及跨服务的协作能力,具备中间件式的路由与缓存、日志记录和监控。
    • 网关与监控:ZEN Coordinator/Zen Enhanced、Prometheus/Loki/Grafana 等监控栈、PostgreSQL 日志记录、Redis 缓存、以及健康检查等。
    • 多模型协作与扩展性:包含“多模型/多模型模型模型管理”的路由与分发逻辑,具备扩展性以便接入更多工具与服务。
  • 安装与运行(简要)
    • 借助 Docker Compose 部署:仓库 README 提供了 docker-compose 的使用方式,执行 docker-compose up -d 即可启动全部服务。
    • 服务端口分布覆盖核心 MCP 服务与支持组件,适合在容器化环境中按依赖顺序启动与扩展。
  • 服务器配置(MCP 客户端需要的启动信息)
    • 客户端需要一个 MCP 服务器的启动配置(JSON 格式),用于与 MCP 服务器建立连接。配置信息示例如下(仅为描述,不涉及具体代码实现):
      • server_name: "ZEN Orchestrator"
      • command: "docker-compose"
      • args: ["up", "-d"] 说明:使用 Compose 启动整套 MCP 服务栈,包含协调器、各 MCP 服务以及监控组件。
    • 说明:这类配置是给 MCP 客户端了解如何启动并连接到 MCP 服务器所需的元信息,实际连接与通信仍通过 MCP 提供的 JSON-RPC 风格接口完成。
  • 基本使用方法
    • 启动:在仓库根目录执行对应该环境的启动命令(如 docker-compose up -d),等待各服务就绪。
    • 交互示例(通过 MCP 端点进行调用):
      • 获取服务列表和健康情况:查询 MCP 服务器提供的 /services 与 /health 接口。
      • 调用工具:通过 /mcp 或 /tools/call 端点提交工具名与参数,MCP 服务器将路由到具体的工具服务并返回结果。
      • 批量执行:通过工具批量调用接口实现多工具连续处理。
    • 运行注意事项:该实现涉及多服务、数据库与缓存,请确保网络、数据库与缓存服务(PostgreSQL、Redis、MQTT 等)可用,且 Docker Compose 配置中环境变量正确设置。

服务器信息