coding-mcp

腾讯 Coding (coding.net) 的 MCP Server，让 Claude 可以直接操作项目缺陷、迭代、成员等。

快速开始

1. 获取访问令牌

进入 Coding → 个人设置 → 访问令牌 → 新建令牌，勾选所需权限（项目、缺陷、迭代等）。

2. 配置环境变量

export CODING_TEAM=yourteam      # 团队域名（yourteam.coding.net 的前缀）
export CODING_TOKEN=your_token   # 个人访问令牌

3. 在 Claude Code 中配置

编辑 ~/.claude/settings.json，添加 MCP server：

{
  "mcpServers": {
    "coding": {
      "command": "node",
      "args": ["/path/to/coding-mcp/dist/index.js"],
      "env": {
        "CODING_TEAM": "yourteam",
        "CODING_TOKEN": "your_token"
      }
    }
  }
}

可用工具

项目

| 工具 | 说明 | |------|------| | list_projects | 列出所有项目 | | get_project | 获取项目详情 |

缺陷

| 工具 | 说明 | |------|------| | list_defects | 查询缺陷列表（支持状态/优先级/经办人/迭代过滤） | | get_defect | 获取缺陷详情 | | create_defect | 创建缺陷 | | update_defect | 更新缺陷字段 | | update_defect_status | 更新缺陷状态 | | delete_defect | 删除缺陷 |

迭代

| 工具 | 说明 | |------|------| | list_iterations | 列出迭代 | | get_iteration | 获取迭代详情 | | create_iteration | 创建迭代 |

成员

| 工具 | 说明 | |------|------| | list_project_members | 列出项目成员（用于分配缺陷） |

扩展指南

新增工具只需：

1. 在 src/tools/ 下新建文件（如 requirements.ts）
2. 导出 xxxTools(client: CodingClient): ToolDefinition[] 函数
3. 在 src/tools/index.ts 的 getAllTools 里 push 进去

参考 defects.ts 的结构即可，无需修改其他文件。

项目结构

src/
├── index.ts          # MCP Server 入口
├── client.ts         # Coding API 客户端（封装 HTTP 调用）
├── types.ts          # 公共类型定义
└── tools/
    ├── index.ts      # 工具注册中心
    ├── defects.ts    # 缺陷相关工具
    ├── projects.ts   # 项目相关工具
    ├── iterations.ts # 迭代相关工具
    └── members.ts    # 成员相关工具