← 返回目录

CircleCI MCP Server

官方

将 CircleCI 开发工作流接入 Model Context Protocol (MCP)，实现 AI 驱动的开发体验。

GitHub 源仓库 ↗

★ 91 Stars 分类 · 开发工具热门源版本 c47ce3fa6f6f

42FMRS · D

可靠性

6/20

安全与权限

10/20

维护活跃度

8/20

文档质量

10/20

安装易用性

8/20

专为 CircleCI 设计的 MCP 服务器，功能全面，覆盖从配置验证到管道触发的全流程。但官方已弃用，建议迁移至 CircleCI 托管 MCP 或 CLI MCP。安装简单，兼容主流 MCP 客户端。

查看 FMRS 评分方法 →

CircleCI MCP Server 是专为集成 CircleCI 开发工作流而设计的 MCP 服务器实现。它充当 CircleCI 基础设施与 Model Context Protocol 之间的桥梁，使开发人员能够通过自然语言与 CircleCI 交互，而无需离开 IDE。该服务器提供多种工具，涵盖配置验证、测试分析、构建日志、制品查看、管道触发等。注意：官方已弃用此包，建议迁移到 CircleCI 的托管 MCP 服务器或 CircleCI CLI MCP。

工具能力

config_helper

验证 CircleCI 配置文件并提供指导。

download_usage_api_data

从 CircleCI 使用 API 下载使用数据。

find_flaky_tests

通过分析测试执行历史识别不稳定测试。

find_underused_resource_classes

查找计算资源利用率低的工作。

get_build_failure_logs

获取 CircleCI 构建的详细失败日志。

get_job_test_results

获取 CircleCI 作业的测试元数据和结果。

get_latest_pipeline_status

获取分支上最新管道的状态。

list_artifacts

列出 CircleCI 作业产生的制品。

list_component_versions

列出 CircleCI 组件的所有版本。

list_followed_projects

列出你关注的所有 CircleCI 项目。

rerun_workflow

从头或从失败作业重新运行工作流。

run_pipeline

触发管道运行。

run_rollback_pipeline

为项目触发回滚。

安装接入

在 CircleCI 设置中创建个人 API 令牌（https://app.circleci.com/settings/user/tokens）。2. 确保 Node.js >= 18 和 pnpm 已安装。3. 在 MCP 客户端配置中添加以下 JSON（以 Cursor 为例）：{

"mcpServers": {
"circleci-mcp-server": {
"command": "npx",
"args": ["-y", "@circleci/mcp-server-circleci@latest"],
"env": {
"CIRCLECI_TOKEN": "your-circleci-token",
"CIRCLECI_BASE_URL": "https://circleci.com",
"MAX_MCP_OUTPUT_LENGTH": "50000"
}
}
}
}4. 重启 IDE 并开始使用。

claude_desktop_config.json

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

使用 Cursor、VS Code、Claude Desktop 等 MCP 兼容客户端的开发人员。
希望在 IDE 中无缝管理 CircleCI 管道的团队。
需要快速诊断构建失败和测试问题的开发者。

不适合谁

需要最新功能和安全更新的用户，因为该包已弃用，不再维护。
寻求托管解决方案的用户，推荐使用 CircleCI 的托管 MCP 服务器。
需要公共网络远程访问的用户，除非部署自管理远程服务器并提供额外安全保障。

所需权限

需要 CircleCI 个人 API 令牌（CIRCLECI_TOKEN），具有项目读取权限。
远程模式下，需要配置允许的主机（MCP_ALLOWED_HOSTS）和认证。
文件功能可能读写文件，需设置 MCP_FILE_OUTPUT_ROOTS 限制根目录。

风险与副作用

令牌持有风险：如果共享或个人令牌泄露，可能导致未授权操作。
弃用风险：该服务器不再维护，可能存在安全漏洞或兼容性问题。
远程模式风险：如果未启用认证（REQUIRE_REQUEST_TOKEN=false），任何能访问端口的人都可操作服务器。

常见排障

清除 npx 缓存：npx clear-npx-cache && npm cache clean --force。
确保使用 @latest 版本，并完全重启 IDE。
检查 CIRCLECI_TOKEN 是否正确，并确保具有项目访问权限。
对于网络问题，检查 CIRCLECI_BASE_URL 是否设置为 https://circleci.com，或配置 npm 代理。
对于远程模式，确保设置 MCP_ALLOWED_HOSTS 为你的域名，否则会收到 403。

使用场景

通过自然语言查询管道状态、构建日志、测试结果等。

直接在 IDE 中触发管道运行或重新运行工作流。

分析测试稳定性、资源利用率，优化 CI/CD 成本。

支持客户端

Cursor完整支持

VS Code完整支持

Claude Desktop完整支持

Claude Code完整支持

Windsurf完整支持

Amazon Q Developer完整支持