From 02a6a8e9ff45be0ce05be0f4dfdfee396f0899c5 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Wed, 11 Feb 2026 13:25:07 +0000 Subject: [PATCH 1/4] Add CircleCI MCP server definition Official CircleCI MCP server for managing pipelines, builds, and workflows. Uses @circleci/mcp-server-circleci npm package with stdio transport. https://claude.ai/code/session_013AxurW8hPAfnUNvik354Xx --- servers/com.circleci-mcp.json | 64 +++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 servers/com.circleci-mcp.json diff --git a/servers/com.circleci-mcp.json b/servers/com.circleci-mcp.json new file mode 100644 index 0000000..0d9af89 --- /dev/null +++ b/servers/com.circleci-mcp.json @@ -0,0 +1,64 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.circleci-mcp", + "name": "CircleCI", + "alias": "circleci", + "description": "Manage CircleCI pipelines, jobs, and workflows. Trigger builds, view job logs, analyze test results, and debug failed pipelines.", + "icon": "https://avatars.githubusercontent.com/u/26607840?v=4", + "schema_version": "2.1", + "categories": ["developer-tools"], + "tags": ["circleci", "ci-cd", "pipelines", "builds", "testing", "deployment"], + + "transport": { + "type": "stdio", + "command": "npx", + "args": ["-y", "@circleci/mcp-server-circleci"], + "env": { + "CIRCLECI_TOKEN": "${input:CIRCLECI_TOKEN}" + }, + "metadata": { + "inputs": [ + { + "id": "CIRCLECI_TOKEN", + "label": "CircleCI API Token", + "description": "Personal API token for CircleCI.", + "type": "password", + "required": true, + "secret": true, + "placeholder": "CCIPAT_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", + "obtain": { + "url": "https://app.circleci.com/settings/user/tokens", + "instructions": "1. Go to app.circleci.com > User Settings > Personal API Tokens\n2. Click 'Create New Token'\n3. Name your token and click 'Add API Token'\n4. Copy the token", + "button_label": "Create Token" + } + } + ] + } + }, + + "auth": { + "type": "api_key", + "instructions": "Create a Personal API Token at https://app.circleci.com/settings/user/tokens" + }, + + "contributor": { + "name": "CircleCI", + "github": "CircleCI-Public", + "url": "https://circleci.com" + }, + + "links": { + "repository": "https://github.com/CircleCI-Public/mcp-server-circleci", + "homepage": "https://circleci.com", + "documentation": "https://circleci.com/docs/guides/toolkit/using-the-circleci-mcp-server/" + }, + + "platforms": ["all"], + + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +} From 8dcb73249dad26c24d71530600647143cce0a6f7 Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 19:08:31 +0800 Subject: [PATCH 2/4] fix: update server definition (input type 'password' -> 'text' for CIRCLECI_TOKEN) --- servers/com.circleci-mcp.json | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/servers/com.circleci-mcp.json b/servers/com.circleci-mcp.json index 0d9af89..7f11e45 100644 --- a/servers/com.circleci-mcp.json +++ b/servers/com.circleci-mcp.json @@ -6,13 +6,24 @@ "description": "Manage CircleCI pipelines, jobs, and workflows. Trigger builds, view job logs, analyze test results, and debug failed pipelines.", "icon": "https://avatars.githubusercontent.com/u/26607840?v=4", "schema_version": "2.1", - "categories": ["developer-tools"], - "tags": ["circleci", "ci-cd", "pipelines", "builds", "testing", "deployment"], - + "categories": [ + "developer-tools" + ], + "tags": [ + "circleci", + "ci-cd", + "pipelines", + "builds", + "testing", + "deployment" + ], "transport": { "type": "stdio", "command": "npx", - "args": ["-y", "@circleci/mcp-server-circleci"], + "args": [ + "-y", + "@circleci/mcp-server-circleci" + ], "env": { "CIRCLECI_TOKEN": "${input:CIRCLECI_TOKEN}" }, @@ -22,7 +33,7 @@ "id": "CIRCLECI_TOKEN", "label": "CircleCI API Token", "description": "Personal API token for CircleCI.", - "type": "password", + "type": "text", "required": true, "secret": true, "placeholder": "CCIPAT_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", @@ -35,26 +46,23 @@ ] } }, - "auth": { "type": "api_key", "instructions": "Create a Personal API Token at https://app.circleci.com/settings/user/tokens" }, - "contributor": { "name": "CircleCI", "github": "CircleCI-Public", "url": "https://circleci.com" }, - "links": { "repository": "https://github.com/CircleCI-Public/mcp-server-circleci", "homepage": "https://circleci.com", "documentation": "https://circleci.com/docs/guides/toolkit/using-the-circleci-mcp-server/" }, - - "platforms": ["all"], - + "platforms": [ + "all" + ], "capabilities": { "tools": true, "resources": false, From 5c22e85dcfe47b99f8641b181cd027f53c7e034b Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:44:02 +0800 Subject: [PATCH 3/4] fix: rename server files with transport suffix - com.circleci-mcp.json -> com.circleci-mcp-npx.json (id: com.circleci-mcp-npx) Signed-off-by: Mohammod Al Amin Ashik --- servers/{com.circleci-mcp.json => com.circleci-mcp-npx.json} | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename servers/{com.circleci-mcp.json => com.circleci-mcp-npx.json} (97%) diff --git a/servers/com.circleci-mcp.json b/servers/com.circleci-mcp-npx.json similarity index 97% rename from servers/com.circleci-mcp.json rename to servers/com.circleci-mcp-npx.json index 7f11e45..a51392b 100644 --- a/servers/com.circleci-mcp.json +++ b/servers/com.circleci-mcp-npx.json @@ -1,7 +1,7 @@ { "$schema": "../schemas/server-definition.schema.json", - "id": "com.circleci-mcp", - "name": "CircleCI", + "id": "com.circleci-mcp-npx", + "name": "CircleCI (npx)", "alias": "circleci", "description": "Manage CircleCI pipelines, jobs, and workflows. Trigger builds, view job logs, analyze test results, and debug failed pipelines.", "icon": "https://avatars.githubusercontent.com/u/26607840?v=4", From 837e0b1ef9a316a0290d1919d5be110a89c335ff Mon Sep 17 00:00:00 2001 From: Mohammod Al Amin Ashik Date: Thu, 19 Feb 2026 22:49:29 +0800 Subject: [PATCH 4/4] feat(circleci): add Docker variant using circleci/mcp-server-circleci image Signed-off-by: Mohammod Al Amin Ashik --- servers/com.circleci-mcp-docker.json | 72 ++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 servers/com.circleci-mcp-docker.json diff --git a/servers/com.circleci-mcp-docker.json b/servers/com.circleci-mcp-docker.json new file mode 100644 index 0000000..7af07bd --- /dev/null +++ b/servers/com.circleci-mcp-docker.json @@ -0,0 +1,72 @@ +{ + "$schema": "../schemas/server-definition.schema.json", + "id": "com.circleci-mcp-docker", + "name": "CircleCI (Docker)", + "alias": "circleci-docker", + "description": "Manage CircleCI pipelines, jobs, and workflows via Docker. Trigger builds, view job logs, analyze test results, and debug failed pipelines.", + "icon": "https://avatars.githubusercontent.com/u/26607840?v=4", + "schema_version": "2.1", + "categories": [ + "developer-tools" + ], + "tags": [ + "circleci", + "ci-cd", + "pipelines", + "builds", + "docker" + ], + "transport": { + "type": "stdio", + "command": "docker", + "args": [ + "run", "-i", "--rm", + "-e", "CIRCLECI_TOKEN", + "circleci/mcp-server-circleci" + ], + "env": { + "CIRCLECI_TOKEN": "${input:CIRCLECI_TOKEN}" + }, + "metadata": { + "inputs": [ + { + "id": "CIRCLECI_TOKEN", + "label": "CircleCI API Token", + "description": "Personal API token for CircleCI.", + "type": "text", + "required": true, + "secret": true, + "placeholder": "CCIPAT_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", + "obtain": { + "url": "https://app.circleci.com/settings/user/tokens", + "instructions": "1. Go to app.circleci.com > User Settings > Personal API Tokens\n2. Click 'Create New Token'\n3. Name your token and click 'Add API Token'\n4. Copy the token", + "button_label": "Create Token" + } + } + ] + } + }, + "auth": { + "type": "api_key", + "instructions": "Create a Personal API Token at https://app.circleci.com/settings/user/tokens" + }, + "contributor": { + "name": "CircleCI", + "github": "CircleCI-Public", + "url": "https://circleci.com" + }, + "links": { + "repository": "https://github.com/CircleCI-Public/mcp-server-circleci", + "homepage": "https://circleci.com", + "documentation": "https://circleci.com/docs/guides/toolkit/using-the-circleci-mcp-server/" + }, + "platforms": [ + "all" + ], + "capabilities": { + "tools": true, + "resources": false, + "prompts": false, + "read_only_mode": false + } +}