CNB MCP服务器

你是否曾经希望自己的AI助手能够直接操作代码托管平台，创建仓库、管理Issue、处理合并请求，甚至触发CI/CD构建？今天要介绍的开源项目CNB MCP服务器，正是为了实现这个目标而设计的。它由腾讯云CNB团队官方打造，让AI能够通过MCP协议与CNB平台（https://cnb.cool）深度集成，实现代码托管和DevOps流程的自动化。

项目基本信息

一、项目介绍

CNB MCP服务器是CNB（云原生构建）平台的官方MCP工具包。CNB是腾讯云推出的代码托管和DevOps平台，支持Git仓库管理、Issue跟踪、合并请求、云原生构建等功能。这个MCP服务器将这些能力通过MCP协议开放给AI，让AI能够用自然语言操作CNB平台。

这个项目提供了40+个MCP工具，覆盖了以下功能领域：

• 组织管理（获取、创建组织，列出子组织）
• 仓库管理（获取、创建仓库，列出仓库）
• Issue管理（创建、更新、查询Issue，管理评论和标签）
• 合并请求管理（创建、更新、合并PR，管理评论）
• 构建管理（启动、停止构建，查询构建状态和日志）
• 云原生开发环境管理（列出、删除工作空间）
• 知识库查询

二、核心优势

功能全面

提供了40+个MCP工具，覆盖了CNB平台的几乎所有核心功能：

• 组织/仓库管理
• Issue管理（完整CRUD + 标签管理）
• 合并请求管理（完整CRUD + 合并功能）
• 构建管理（启动/停止/查询/日志）
• 云原生开发环境管理
• 知识库查询

官方出品，稳定可靠

由腾讯云CNB团队官方开发和维护，与CNB平台API同步更新，兼容性和稳定性有保障。

多种集成方式

支持STDIO模式，可与Claude Desktop、Cursor等MCP客户端无缝集成。

自动化工作流

AI可以自动化执行从代码提交到构建部署的完整DevOps流程。

开发者友好

提供了完整的开发指南，包括：

• 使用OpenAPI规范自动生成类型定义
• 使用CodeBuddy根据swagger.json自动补充MCP Tools
• 支持MCP Inspector进行调试

三、适用场景

AI驱动的DevOps自动化

让AI自动创建仓库、管理Issue、处理合并请求、触发构建，实现从代码到部署的全流程自动化。

团队协作助手

AI可以根据自然语言指令，在CNB上创建Issue、分配任务、更新状态，提高团队协作效率。

CI/CD集成

将CNB MCP集成到AI编程工具中，实现代码提交后的自动构建和部署。

项目管理自动化

AI可以自动生成项目报告、统计Issue和PR数据、跟踪进度。

知识库查询

通过知识库查询工具，AI可以检索CNB平台的文档和帮助信息。

四、安装教程

系统要求

安装步骤

第一步：获取CNB API令牌

1. 登录CNB平台：https://cnb.cool
2. 进入个人设置 -> 访问令牌
3. 创建新的访问令牌，授予所需权限
4. 复制并保存令牌

第二步：配置MCP客户端

在MCP配置文件中添加以下配置：

{
  "mcpServers": {
    "cnb": {
      "command": "npx",
      "args": ["-y", "-p", "@cnbcool/mcp-server", "cnb-mcp-stdio"],
      "env": {
        "API_BASE_URL": "https://api.cnb.cool",
        "API_TOKEN": "你的CNB令牌"
      }
    }
  }
}

• API_BASE_URL：可选，默认为https://api.cnb.cool
• API_TOKEN：必填，你的CNB个人访问令牌

第三步：重启客户端

保存配置文件后，重启Cursor或Claude Desktop。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来调用CNB的各种功能了。

示例1：组织管理

用户指令：“列出我在CNB上所有有权限的组织”

AI会调用cnb_list_groups工具，返回组织列表。

创建组织：“创建一个名为‘my-team’的新组织”

AI会调用cnb_create_group工具。

示例2：仓库管理

用户指令：“在‘my-team’组织下创建一个名为‘awesome-project’的公开仓库”

AI会调用cnb_create_repository工具。

列出仓库：“列出‘my-team’组织下的所有仓库”

AI会调用cnb_list_group_repositories工具。

示例3：Issue管理

用户指令：“在仓库‘my-team/awesome-project’中创建一个Issue，标题是‘修复登录页面的bug’，内容详细描述问题”

AI会调用cnb_create_issue工具。

添加标签：“给这个Issue添加‘bug’和‘high-priority’标签”

AI会调用cnb_add_issue_labels工具。

列出Issue：“列出所有未关闭的Issue”

AI会调用cnb_list_issues工具。

示例4：合并请求管理

用户指令：“创建一个从feature分支到main分支的合并请求，标题是‘添加用户认证功能’”

AI会调用cnb_create_pull工具。

合并PR：“合并#123号合并请求”

AI会调用cnb_merge_pull工具。

示例5：构建管理

用户指令：“启动仓库‘my-team/awesome-project’的构建”

AI会调用cnb_startBuild工具。

查询构建状态：“查看最新的构建状态”

AI会调用cnb_getBuildStatus工具。

示例6：云原生开发环境

用户指令：“列出我所有的云原生开发环境”

AI会调用cnb_list_workspaces工具。

删除环境：“删除名为‘dev-env’的开发环境”

AI会调用cnb_delete_workspace工具。

示例7：知识库查询

用户指令：“查询CNB平台如何使用云原生构建”

AI会调用cnb_queryKnowledgeBase工具，返回相关文档。

六、常见问题

问题1：提示“API_TOKEN环境变量未设置”

解决方案：请检查MCP配置中的env部分，确保API_TOKEN正确设置。

问题2：API调用返回403权限错误

解决方案：

• 确认访问令牌有调用相应API的权限
• 检查用户是否有所操作资源的访问权限

问题3：无法创建仓库或组织

解决方案：

• 确认用户有创建权限
• 检查组织名称或仓库名称是否符合命名规范
• 确认同一命名空间下没有重名资源

问题4：Node.js版本要求

解决方案：CNB MCP要求Node.js 18或以上版本。可以通过node -v检查版本，必要时升级。

问题5：开发模式下使用MCP Inspector

解决方案：

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

注意：MCP Inspector需要Node.js 22.7.5或以上版本。

七、总结

CNB MCP服务器是腾讯云CNB平台的官方MCP工具包，提供了40+个工具，覆盖了代码托管和DevOps的核心功能。它是目前功能最全面的代码托管平台MCP服务器之一。

这个项目的最大价值在于：

1. 功能全面：40+个工具覆盖组织、仓库、Issue、PR、构建、开发环境等
2. 官方维护：由腾讯云CNB团队官方支持，稳定可靠
3. 自动化工作流：AI可以执行从代码到构建的完整DevOps流程
4. 开发者友好：提供了完善的开发指南和调试工具
5. 多场景适用：从个人项目到团队协作，从代码管理到CI/CD

如果你是CNB平台的用户，并且使用AI编程工具，CNB MCP服务器将极大地提升你的开发效率和DevOps自动化水平。