← 返回目录

CircleCI MCP Server

官方

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

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 339 / 438
Stars: ★ 93 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · Docker
凭据: 需要 API Key / 凭据
许可证: 其他 / 未声明
最近提交: 2 个月前
工具数: 13

42FMRS · D

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

最强项 · 文档质量 10/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

10/20

维护活跃度

8/20

文档质量

10/20

安装易用性

8/20

查看各项评分依据

可靠性 6/20: 源码目录中未见实际测试文件或CI配置，无法验证服务器关键路径的真实执行情况。README声明了工具列表和传输方式，但缺少可复现的测试证据。工具行为描述详尽，但无法确认与实际实现完全一致。因此可靠性评分较低。
安全与权限 10/20: 认证设计较为谨慎：远程模式默认要求请求令牌，并在共享令牌模式下强制要求显式确认（MCP_ALLOW_UNAUTHENTICATED_NETWORK_ACCESS）。文件写入限制在受控根目录内。但未发现对破坏性操作的确认机制（如run_pipeline等触发操作未提及用户确认），且依赖外部mcp-remote和提供示例均使用npx -y，安全性依赖框架。整体安全设计合理，但仍有改进空间。
维护活跃度 8/20: 仓库声明已弃用，不再接收功能更新，将被归档，但仍有维护活动。存在开源许可（Apache 2.0）和社区版本管理。未观察到持续提交和版本发布节奏。安全响应渠道未明确。总体维护状态尚可，但因弃用状态和未验证的更新路径略有扣分。
文档质量 10/20: 文档非常详尽：提供多种客户端的安装配置示例、远程部署模式说明、工具详细描述、环境变量解释、故障排除指导和开发指南。但作为静态审查，无法验证文档与实际行为的完全一致性。文档对限制和安全性有充分说明。
安装易用性 8/20: 安装步骤清晰，支持npx和Docker，提供多个主流IDE的配置示例（Cursor、VS Code、Claude Desktop等）。远程部署有详细说明。但未发现包含实际测试的CI验证，且依赖Node.js和pnpm等外部工具，安装依赖较多。总体安装流程清晰，但复杂度较高。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

使用 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），任何能访问端口的人都可操作服务器。

安装接入

准备工作

运行环境：Node.js 18+ · Docker

CIRCLECI_TOKEN 必填密钥 CircleCI Personal API Token，在 app.circleci.com/settings/user/tokens 创建。

其他可选配置项（10 个）

CIRCLECI_BASE_URL 可选 CircleCI API 地址，默认 https://circleci.com，仅本地化部署需要设置。

MAX_MCP_OUTPUT_LENGTH 可选 MCP 响应最大输出长度，默认 50000。

REQUIRE_REQUEST_TOKEN 可选远程模式下是否要求每请求携带 token，默认开启。

MCP_ALLOW_UNAUTHENTICATED_NETWORK_ACCESS 可选允许在非回环地址上运行无认证共享 token 模式时的显式确认。

MCP_ALLOWED_HOSTS 可选远程部署时额外允许的 Host 头列表，公网部署必填。

MCP_ALLOWED_ORIGINS 可选额外允许的 Origin 头列表，仅浏览器直连时需要。

MCP_BIND_HOST 可选远程模式监听的网络接口，默认 0.0.0.0。

MCP_FILE_OUTPUT_ROOTS 可选允许文件读写工具访问的额外目录列表。

DISABLE_TELEMETRY 可选设为 true 可关闭使用指标导出。

FILE_OUTPUT_DIRECTORY 可选 find_flaky_tests 以文件模式输出时使用的目录。

在 CircleCI 设置中创建个人 API 令牌（https://app.circleci.com/settings/user/tokens）。
确保 Node.js >= 18 和 pnpm 已安装。
在 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 并开始使用。

.cursor/mcp.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 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com -e MAX_MCP_OUTPUT_LENGTH=50000 -- npx -y @circleci/mcp-server-circleci@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中确认出现 config_helper、list_followed_projects 等工具，然后询问“列出我关注的 CircleCI 项目”以验证 token 有效。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我关注的 CircleCI 项目
获取 main 分支最新一次构建失败的日志
检查我的 .circleci/config.yml 配置是否有效
从失败的 job 重新运行该 workflow

工具能力 13

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 作业产生的制品。

展开其余 5 个工具

list_component_versions 只读

列出 CircleCI 组件的所有版本。

list_followed_projects 只读

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

rerun_workflow 写入

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

run_pipeline 写入

触发管道运行。

run_rollback_pipeline 破坏性

为项目触发回滚。

使用场景

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

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

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

支持客户端

Cursor

VS Code

Claude Desktop

Claude Code

Windsurf

Amazon Q Developer

依据项目文档列出，未经本站实测。

详细介绍

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