开发版本管理 MCP Server

一个基于 Node.js 的 MCP（Model Context Protocol）Server，用于管理开发版本升级改动记录。

功能

| 工具 | 说明 | |------|------| | add_version | 新增一条版本升级改动记录 | | list_versions | 查询所有版本记录列表 |

工作流程

功能一：自动记录 Git 提交变更

开发同学在 IDEA 中完成代码开发
        ↓
提交 Git，附带改动描述
        ↓
CodeBuddy/WorkBuddy 中的 AI 读取提交信息
        ↓
AI 自动总结改动内容
        ↓
调用 MCP 工具 add_version → 后端 /version/add 接口
        ↓
版本改动记录保存成功

功能二：对话查询版本列表

用户在 CodeBuddy/WorkBuddy 中提问：
  "列出系统的所有版本"
        ↓
AI 调用 MCP 工具 list_versions → 后端 /version/list 接口
        ↓
返回版本列表展示给用户

认证说明

后端管理系统已接入认证服务，MCP Server 调用 API 时需要通过 CRM_MCP_ACCESS_KEY 标识用户身份。

获取 Access Key

1. 打开浏览器，访问后端管理系统
2. 使用账号密码登录
3. 登录成功后，系统会生成一个 access-key
4. 复制该 key，配置到 MCP Server 的环境变量 CRM_MCP_ACCESS_KEY 中

无感传递

MCP Server 在每次请求后端 API 时，自动在 HTTP 请求头中添加：

CrmMcpAccessKey: <你的access-key>

开发者无需手动传参即可完成认证。

安装

方式一：全局安装（推荐）

npm install -g dev-version-mcp-server

方式二：npx 直接运行（无需安装）

无需安装，npx 自动下载并运行。

配置 MCP

CodeBuddy 配置

在 CodeBuddy 的 MCP 配置中添加：

已全局安装的情况：

{
  "mcpServers": {
    "dev-version": {
      "command": "dev-version-mcp-server",
      "env": {
        "VERSION_API_BASE_URL": "http://你的后端服务地址:端口",
        "CRM_MCP_ACCESS_KEY": "从管理系统获取的access-key"
      }
    }
  }
}

使用 npx（无需安装）：

{
  "mcpServers": {
    "dev-version": {
      "command": "npx",
      "args": ["-y", "dev-version-mcp-server"],
      "env": {
        "VERSION_API_BASE_URL": "http://你的后端服务地址:端口",
        "CRM_MCP_ACCESS_KEY": "从管理系统获取的access-key"
      }
    }
  }
}

WorkBuddy 配置

在 WorkBuddy 设置中找到 MCP 配置，添加同上配置。

环境变量

| 变量名 | 说明 | 默认值 | 必填 | |--------|------|--------|------| | VERSION_API_BASE_URL | 后端版本管理服务的地址 | http://localhost:3000 | 否 | | CRM_MCP_ACCESS_KEY | 登录管理系统后获取的 access-key | 无 | 是 |

后端 API 要求

MCP Server 依赖的后端服务需要提供以下接口：

POST /version/add

请求头需要携带 CrmMcpAccessKey: <access-key> 进行身份认证。

{
  "versionNo": "v1.2.0",
  "changeContent": "新增用户登录模块，优化首页加载速度",
  "submitter": "张三"
}

GET /version/list

请求头需要携带 CrmMcpAccessKey: <access-key> 进行身份认证。

返回版本记录列表数组。

项目结构

dev-version-mcp-server/
├── package.json
├── README.md
└── src/
    ├── index.js      # MCP Server 入口，注册工具
    └── client.js     # HTTP 客户端，对接后端 API（含认证）

使用示例

安装并配置好 MCP Server 后，在 CodeBuddy 中可以这样使用：

用户: "我刚提交了代码，commit 信息是 feat: 新增商品搜索功能，优化数据库查询，版本号 v2.1.0"

AI: [自动调用 add_version 工具，将总结后的改动内容、版本号、提交人记录到后端]

用户: "列出所有版本更新记录"

AI: [调用 list_versions 工具，展示版本列表]

本地开发

git clone <仓库地址>
cd dev-version-mcp-server
npm install