mcp-server-circleci
The CircleCI MCP Server is designed to integrate with CircleCI, enabling natural language commands to manage continuous integration tasks. It supports tools like retrieving build logs, identifying flaky tests, and getting pipeline statuses, making it easier to perform operations without visiting the CircleCI web UI.
CircleCI MCP Server
Model Context Protocol (MCP) is a standardized protocol for managing context between large language models (LLMs) and external systems. This repository provides an MCP Server for CircleCI, allowing users to interact with CircleCI using natural language through platforms like Cursor IDE, Windsurf, and Copilot.
Requirements
- CircleCI API token
- pnpm package manager
- Node.js >= v18.0.0
- Docker
Supported Tools
- Retrieve detailed failure logs from CircleCI builds
- Identify flaky tests using test execution history
- Retrieve the status of the latest pipeline
- Get test metadata for CircleCI jobs
- Validate CircleCI configuration tasks
Installation
The CircleCI MCP Server can be installed and configured using NPX or Docker across various platforms such as Cursor, VS Code, Claude Desktop, Claude Code, Windsurf, and Smithery.