项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器端实现，专注于与 CODING DevOps 平台进行集成。它使得支持 MCP 协议的 LLM 客户端（如 Warp AI）能够直接与您的 CODING DevOps 账号交互，执行项目管理、工作项管理和代码仓库相关的操作。

主要功能点

项目管理：查询用户可访问的项目列表。
工作项管理：创建、查询、删除事项（如缺陷、需求、任务），支持按类型筛选，并能将需求拆解为子任务。
代码仓库管理：查询指定项目的仓库列表、分支提交记录，并能基于本地 Git 仓库信息创建合并请求。

安装步骤

确保您的系统已安装 Node.js 和 Git。

使用 Git 克隆本项目仓库到本地：

git clone https://github.com/yupengfei1209/coding_devops_mcp_server.git
cd coding_devops_mcp_server

安装项目依赖：
```
npm install
```
构建服务器代码：
```
npm run build
```
构建成功后，可执行的服务器脚本通常位于项目目录下的 'build/index.js' 文件。

服务器配置（用于 MCP 客户端）

这是一个 MCP 服务器，它需要被您的 MCP 客户端（例如 Warp AI）配置并启动。您需要在客户端的配置中指定如何运行本服务器，并提供必要的认证信息。

典型的 MCP 客户端配置通常是一个 JSON 格式的文件，其中会包含一个 'mcpServers' 部分。您需要在此部分添加一个条目来配置本服务器，指定其启动命令、参数和环境变量。

启动命令 (command): 通常是 'node'。
启动参数 (args): 一个数组，包含传递给命令的参数。第一个参数应是您构建后生成的服务器脚本文件（'build/index.js'）的完整路径。
环境变量 (env): 一个对象，包含服务器运行所需的敏感信息。必需配置 'CODING_TOKEN' 环境变量，其值是您在 CODING DevOps 平台生成的 Personal Access Token。这个 Token 需要具备访问您希望通过服务器操作的项目、工作项和代码仓库的权限。

请根据您的 MCP 客户端的具体配置格式，添加本服务器的配置信息。

基本使用方法

配置并启动本 MCP 服务器后，您的 LLM 客户端将通过 MCP 协议与之通信。LLM 将能够发现本服务器提供的各项工具（如列出项目、创建工作项、创建合并请求等）。

您可以通过向 LLM 客户端提问或下达指令，让其调用本服务器提供的功能。例如：

“帮我列出我在 CODING DevOps 上的所有项目。” (LLM 可能会调用 'list_projects' 工具)
“在 [项目名称] 里创建一个需求，标题是...，描述是...，优先级是...。” (LLM 可能会调用 'create_issue' 工具)
“查看 [项目名称] 里编号为 [事项编号] 的事项详情。” (LLM 可能会调用 'describe_issue' 工具)
“根据我的当前代码提交，在工作目录 [路径] 为项目创建一个合并请求，标题是...，描述是...。” (LLM 可能会调用 'create_merge_request' 工具)

LLM 客户端会负责解析您的自然语言指令，匹配到对应的工具，组织参数，并通过 MCP 协议向本服务器发送工具调用请求。服务器执行操作后，会将结果通过 MCP 响应返回给 LLM 客户端，最终由 LLM 向您呈现。

关键词

信息