mcp-server-circleci
Author: CircleCI-Public
Description: Model-Context-Protocol (MCP) server that exposes CircleCI operations (e.g. get_build_failure_logs, run_pipeline) to AI/IDE clients.
Stars: 58
Forks: 28
License: Other (NOASSERTION)
Category: Open Source
Overview
Installation
1. Prerequisites:
• Node.js ≥ 18.x
• npm ≥ 9.x (or yarn/pnpm)
• A CircleCI personal API token with at least `status` scope
2. Clone the repository:
git clone https://github.com/CircleCI-Public/mcp-server-circleci.git
cd mcp-server-circleci3. Install dependencies:
npm install
# or
yarn install4. Build the TypeScript source:
npm run build # compiles to ./dist5. Configure environment variables (create a `.env` file or export vars):
CIRCLECI_TOKEN=<your-circleci-api-token>
PORT=3000 # server listen port (default 3000)
LOG_LEVEL=info # trace | debug | info | warn | error6. Start the MCP server:
npm start # runs node dist/index.js7. (Optional) Run the test suite and linter:
npm test
npm run lintLicense: Other (NOASSERTION)
Updated 7/30/2025