MCP.so
登录

CircleCI MCP Server

@CircleCI-Public

基本信息

分类

其他

许可证

NOASSERTION

传输方式

stdio

作者

CircleCI-Public

关于 CircleCI MCP Server

A specialized server implementation for the Model Context Protocol (MCP) designed to integrate with CircleCI's development workflow. This project serves as a bridge between CircleCI's infrastructure and the Model Context Protocol, enabling enhanced AI-powered development experien

CircleCI MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-circleci": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@CircleCI-Public/mcp-server-circleci",
        "--client",
        "claude"
      ]
    }
  }
}

CircleCI MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is CircleCI MCP Server?

A Model Context Protocol (MCP) server that integrates CircleCI with MCP-compatible clients (Cursor, Windsurf, Claude, Amazon Q Developer CLI, etc.), enabling natural‑language interaction with CircleCI pipelines, workflows, tests, and configuration. Built for developers who want to manage CircleCI projects without leaving their IDE.

How to use CircleCI MCP Server?

Requires a CircleCI Personal API token and either Node.js ≥18 (with pnpm) for the NPX runner, or Docker. Add the server to your MCP client’s config (e.g., mcpServers in Cursor) using the command npx -y @circleci/mcp-server-circleci@latest or the Docker image circleci/mcp-server-circleci. Set the CIRCLECI_TOKEN environment variable; optionally set CIRCLECI_BASE_URL for on‑premises customers and MAX_MCP_OUTPUT_LENGTH (default 50000).

Key features of CircleCI MCP Server?

  • Analyze git diffs against cursor rules for violations
  • Validate and get guidance for your CircleCI configuration
  • Download usage data from the CircleCI Usage API
  • Identify flaky tests from test execution history
  • Find jobs with underused compute resources
  • Retrieve build failure logs and job test results
  • Get the latest pipeline status for a branch
  • List artifacts, followed projects, and component versions
  • Rerun workflows from start or from the failed job
  • Trigger pipelines and rollback pipelines

Use cases of CircleCI MCP Server?

  • Debug build failures by pulling failure logs directly from your IDE
  • Optimise resource usage by detecting under‑utilised compute classes
  • Automate pipeline re‑runs and rollbacks during incident response
  • Review flaky test patterns without switching to the CircleCI dashboard
  • Validate CircleCI configuration files before committing changes

常见问题

1

What runtime dependencies are required?

Node.js version 18 or later and pnpm (for NPX runs) or Docker. A CircleCI Personal API token is mandatory.

2

How do I get a CircleCI API token?

Create a Personal API token at `https://app.circleci.com/settings/user/tokens`. See the official documentation for details.

3

Can I use this server with an on‑premises CircleCI installation?

Yes. Set the `CIRCLECI_BASE_URL` environment variable to your on‑premises instance URL.

4

What does `MAX_MCP_OUTPUT_LENGTH` control?

It limits the maximum output length for MCP responses. The default is 50,000 characters, and it is optional.

5

Which MCP clients are supported?

Cursor, VS Code, Claude Desktop, Claude Code, Windsurf, Amazon Q Developer CLI, and any MCP‑compatible client. The README provides per‑client configuration examples.

评论

其他 分类下的更多 MCP 服务器