CircleCI MCP Server

Name: CircleCI MCP Server
Author: CircleCI-Public

@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

#mcp-server #modelcontextprotocol

基本信息

分类

其他

许可证

NOASSERTION

运行时

node

传输方式

stdio

发布者

CircleCI-Public

配置

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

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from CircleCI MCP Server

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.

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.

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.

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.

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 服务器

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K