CODING DevOps MCP Server

CODING DevOps MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，用于与 CODING DevOps 平台进行交互。它提供了一套标准化的接口，使得用户可以方便地管理 CODING 平台上的项目和工作项。

功能特性

• 项目管理
  • 列出用户可访问的项目
  • 按项目名称搜索项目
  • 单个项目查询
  • 项目公告创建
  • 项目凭据列表查询
  • 根据项目集名称查询
  • 项目集创建
  • 项目集下项目列表查询
• 工作项（Issues）管理
  • 创建工作项
  • 列出工作项
  • 删除工作项
  • 支持工作项类型、优先级等属性设置
  • 事项描述修改
  • 事项详情查询
  • 事项附件的下载地址查询
  • 前置事项删除
  • 前置事项查询
  • 前置事项添加
  • 后置事项查询
  • 子事项列表查询
  • 工时日志列表查询
  • 工时登记
  • 用户在团队内的所有代办事项查询
• 版本管理
  • 版本列表查询
  • 版本创建
  • 版本发布范围查询
  • 版本详情查询
• 迭代管理
  • 迭代列表获取
  • 迭代创建
  • 迭代详情查询
• 需求管理
  • 需求关联缺陷
  • 需求关联缺陷列表查询
  • 需求取消关联缺陷
• 代码仓库
  • 为某次提交创建评论
  • 修改提交对应的流水线状态
  • 查询提交对应的流水线状态
  • 获取提交注释
  • 创建代码仓库
  • 修改仓库描述
  • 查询git仓库的贡献者
  • 查询项目下所有的仓库信息列表
  • 查询仓库规范列表
  • 查询仓库规范详情
  • 查询保护分支列表
  • 创建git合并请求
  • 创建合并请求行评论和改动文件diff行评论
  • 查询合并请求列表
  • 查询合并请求详情信息
  • 获取自己的合并请求列表
  • 获取项目下的合并请求列表
• 持续集成
  • 构建任务统计
  • 构建完整日志查询（原始日志 Raw）
  • 构建触发
  • 构建计划创建
  • 构建计划度量查询
  • 构建计划查询（通过项目ID）
  • 构建计划环境变量获取
  • 构建计划的构建列表获取
  • 构建计划详情获取
• 制品仓库
  • 制品仓库创建
  • 制品列表查询
  • 制品包（镜像）列表查询
  • 制品版本列表查询
• 测试管理
  • 测试任务关联的缺陷列表
  • 测试任务关联缺陷
  • 测试任务列表
  • 测试任务详情
  • 测试报告列表
  • 测试报告详情
  • 测试用例列表
  • 测试用例创建
  • 测试用例详情
  • 测试计划列表
  • 测试计划详情
  • 测试计划创建
  • 需求关联的测试用例列表

环境要求

node >= 18

安装

1. Install dependencies:

npm install

2. Build the server:

npm run build

配置

服务器需要以下配置项：

1. CODING Personal Access Token (必需)
2. 项目名称 (可选)

添加到 MCP Client

{
  "mcpServers": {
    "coding-devops": {
      "command": "node",
      "args": [
        "/your_path/coding_mcp_server/build/index.js"
      ],
      "env": {
        "CODING_TOKEN": "coding-token",
        "PROJECT": "default project" // 默认项目,可选配置
      },
      "disabled": false,
      "autoApprove": []
    },
  }
}

功能

其余功能可通过闻讯获得参数。

项目管理

• list_projects: 列出用户可访问的项目

  // 可选参数
  {
    projectName?: string; // 按项目名称筛选
  }

工作项管理

• list_work_items: 列出工作项

  // 参数
  {
    projectName: string;
    issueType?: string;
    limit?: string;
    offset?: string;
    sortKey?: string;
    sortValue?: string;
  }

• create_work_item: 创建工作项

  // 参数
  {
    projectName: string;
    name: string;
    type: string;
    priority: string;
    description: string;
  }

• delete_work_item: 删除工作项

  // 参数
  {
    projectName: string;
    issueCode: number;
  }

开发

项目结构

src/
├── api/               # API 实现
├── config/            # 配置相关
├── tools/            # 工具实现
│   ├── issue/        # 工作项相关功能
│   └── project/      # 项目相关功能
├── errors.ts         # 错误定义
└── index.ts         # 主入口文件

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。