项目简介 这是一个基于Model Context Protocol (MCP) 实现的服务器,旨在为开发团队提供一个幽默且本地化的生产环境部署决策。它兼容GitHub Copilot等MCP客户端,通过提供决策工具,帮助团队判断今天是否适合部署到生产环境,并给出有趣的理由。

主要功能点

  • 部署决策查询:根据日期(默认是今天)和语言,查询是否允许部署到生产环境,并返回“允许”、“谨慎”、“阻止”或“禁止”的决策,以及一个随机生成的幽默理由。
  • 理由列表获取:获取所有决策类型(允许、谨慎、阻止、禁止)对应的完整幽默理由列表,支持多语言。
  • 多语言支持:决策结果、理由和消息支持英语、法语、德语等多种语言,默认法语。
  • 多传输协议:支持标准输入输出 (Stdio) 协议和 HTTP 协议,方便不同类型的客户端集成。
  • GitHub Copilot兼容:设计为可与GitHub Copilot等兼容MCP协议的LLM客户端无缝集成。

安装步骤

  1. 克隆仓库: 打开终端或命令行,运行以下命令克隆项目仓库:
    git clone https://github.com/ltoinel/MCP-Estcequonmetenprodaujourdhui.git
    cd MCP-Estcequonmetenprodaujourdhui
  2. 安装依赖: 运行以下命令安装项目所需的全部依赖:
    npm install
  3. 编译项目: 运行以下命令编译TypeScript源代码到JavaScript:
    npm run build

完成以上步骤后,服务器代码即可运行。

服务器配置 MCP客户端(例如VS Code的MCP扩展)需要配置本MCP服务器的启动命令和参数才能进行连接。以下是基于项目信息生成的配置范例:

{
  "servers": {
    "estcequonmetenprodaujourdhui": {
      "type": "stdio", // 服务器的传输类型,这里是标准输入输出
      "command": "node", // 用于启动服务器的可执行文件或命令
      "args": ["dist/mcp-stdio-server.js"] // 传递给命令的参数,指定要运行的MCP Stdio服务器脚本
    }
  }
}

说明:

  • '"estcequonmetenprodaujourdhui"': 服务器的唯一名称。
  • '"type": "stdio"': 指定使用标准输入输出(Stdio)作为通信协议。
  • '"command": "node"': 指示客户端使用'node'命令来启动服务器。
  • '"args": ["dist/mcp-stdio-server.js"]': 'node'命令的参数,指向编译后的MCP Stdio服务器脚本。

如果您想通过HTTP协议连接,需要运行HTTP服务器并在客户端配置相应的HTTP地址。

基本使用方法

  1. 启动Stdio服务器: 在终端中运行:

    npm start

    服务器将通过标准输入输出与MCP客户端通信,通常无需手动交互。

  2. 启动HTTP服务器: 在另一个终端中运行:

    npm run start-http

    服务器将在 'http://localhost:3000/mcp' 上监听MCP协议的HTTP请求。您可以直接通过HTTP客户端测试MCP协议调用工具的功能:

    curl -X POST http://localhost:3000/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"call_tool","params":{"name":"check_deployment_status","arguments":{"date":"2025-10-26","lang":"fr"}}}'

    此外,为了方便调试,HTTP服务器还提供了非MCP协议的GET接口来查询状态或理由:

    # 查询指定日期的部署状态
    curl "http://localhost:3000/status?date=2025-10-26&lang=fr"
    # 查询所有决策理由
    curl "http://localhost:3000/reasons?lang=fr"

信息

分类

开发者工具