Eng Platform MCP 服务器集成

使用说明(Markdown 格式)

  • 项目简介 Eng Platform MCP 服务器集成是一组围绕 Model Context Protocol 构建的后端服务器实现集合,旨在向大型语言模型客户端提供可访问的上下文资源、可执行工具以及可渲染的提示模板,并通过标准的 JSON-RPC 进行交互,支持 SSE、stdio 和 HTTP 传输。

  • 主要功能点

    • MCP 核心能力:提供 initialize、tools/list、tools/call、notifications/_initialized 等 MCP 请求的处理,返回符合协议的 JSON-RPC 响应。
    • 资源、工具与提示模板托管:实现多类 MCP 服务器,例如资源管理、任务分析、报告生成、团队分析等,便于 LLM 调用外部功能和获取上下文。
    • 传输协议支持:内置对 SSE 与 stdio 等传输方式的支持,便于本地开发调试(stdio)与服务端部署(SSE/HTTP)。
    • 会话与安全:提供会话管理、能力声明与简单的鉴权扩展机制(如 /health、/sse、/messages 路由)。
    • 插件化与模板化:包含用于快速创建新 MCP 服务的模版(如 mcp-saas-template),便于快速搭建新的服务器。
  • 安装与运行(简要步骤)

    1. 克隆代码库到本地或服务器。
    2. 针对不同语言实现的服务器分别安装依赖:
      • 对于 Python 工程(如 constraint-validator、postgres、mysql、报告生成器等),确保安装了 Python 及所需依赖(如 aiohttp、httpx、z3 等)。
      • 对于 Node.js 工程(如 team-analytics、beads-integration、smart-memory 等),确保安装了 Node.js,并执行相应的 npm/yarn 安装。
    3. 逐个启动 MCP 服务器,例如:
      • Python 服务器(constraint-validator 等):python3 mcp-servers/constraint-validator/server.py
      • Node.js 服务器(team-analytics、report-writer、smart-memory 等):node mcp-servers/team-analytics/server.js
    4. 客户端连接配置:通过 JSON-RPC 向对应服务器发起请求,使用 SSE 或 stdio 传输时,请按服务器的实际接口文档进行连接。
  • 服务器配置(JSON 配置用于 MCP 客户端启动连接,非客户端代码) 说明:MCP 客户端需要一个简要的 JSON 配置来启动并连接一个 MCP 服务器。以下 JSON 字段用于描述服务器的启动参数,具体字段含义如下(请勿直接拷贝代码,仅作配置示例;实际配置应结合各服务器的启动方式): { "server_name": "constraint-validator", "command": "python3", "args": ["mcp-servers/constraint-validator/server.py", "--port", "9385"], "transport": "sse" // 可选:sse、stdio、both } 说明:

    • server_name:服务器在 MCP 客户端侧的名称,应与服务器实现中的 server 名称保持一致(如 constraint-validator、report-writer、team-analytics 等)。
    • command/args:用于启动服务器的命令和参数;如 Python 服务器通常以 python3 启动,Node 服务器以 node 启动。
    • transport:指定传输模式,SSE 适合远程部署,stdio 适合本地嵌入式场景,both 则同时开启两种传输方式。
  • 基本使用方法

    • 通过 JSON-RPC 向 MCP 服务器发送请求,例如初始化、列出工具、执行工具等:
      • initialize:声明协议版本、能力等。
      • tools/list:获取服务器提供的工具清单。
      • tools/call:调用具体工具并获取结果。
    • 根据服务器的实现,选择 SSE 或 stdio 作为传输方式;stdio 适合本地调试和 Claude Desktop 集成,SSE 适合远程服务化部署。
    • 生产环境建议对服务器进行鉴权与访问控制,使用健康监控端点(如 /health)观察运行状态。
  • 备注 本仓库包含多种 MCP 服务器实现与模版,适合作为企业内部可扩展的后端上下文服务平台。使用前请结合实际需求选择合适的服务器实现,并按各自的依赖和启动方式进行部署。

服务器信息