Skip to content

Commit 0948bda

Browse files
its-mashits-mash
authored
feat: add CircleCI MCP server definition (#30)
* 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 * fix: update server definition (input type 'password' -> 'text' for CIRCLECI_TOKEN) * 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 <maa.ashik00@gmail.com> * feat(circleci): add Docker variant using circleci/mcp-server-circleci image Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com> --------- Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent d2295f2 commit 0948bda

2 files changed

Lines changed: 144 additions & 0 deletions

File tree

‎servers/com.circleci-mcp-docker.json‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.circleci-mcp-docker",
4+
"name": "CircleCI (Docker)",
5+
"alias": "circleci-docker",
6+
"description": "Manage CircleCI pipelines, jobs, and workflows via Docker. Trigger builds, view job logs, analyze test results, and debug failed pipelines.",
7+
"icon": "https://avatars.githubusercontent.com/u/26607840?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"developer-tools"
11+
],
12+
"tags": [
13+
"circleci",
14+
"ci-cd",
15+
"pipelines",
16+
"builds",
17+
"docker"
18+
],
19+
"transport": {
20+
"type": "stdio",
21+
"command": "docker",
22+
"args": [
23+
"run", "-i", "--rm",
24+
"-e", "CIRCLECI_TOKEN",
25+
"circleci/mcp-server-circleci"
26+
],
27+
"env": {
28+
"CIRCLECI_TOKEN": "${input:CIRCLECI_TOKEN}"
29+
},
30+
"metadata": {
31+
"inputs": [
32+
{
33+
"id": "CIRCLECI_TOKEN",
34+
"label": "CircleCI API Token",
35+
"description": "Personal API token for CircleCI.",
36+
"type": "text",
37+
"required": true,
38+
"secret": true,
39+
"placeholder": "CCIPAT_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
40+
"obtain": {
41+
"url": "https://app.circleci.com/settings/user/tokens",
42+
"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",
43+
"button_label": "Create Token"
44+
}
45+
}
46+
]
47+
}
48+
},
49+
"auth": {
50+
"type": "api_key",
51+
"instructions": "Create a Personal API Token at https://app.circleci.com/settings/user/tokens"
52+
},
53+
"contributor": {
54+
"name": "CircleCI",
55+
"github": "CircleCI-Public",
56+
"url": "https://circleci.com"
57+
},
58+
"links": {
59+
"repository": "https://github.com/CircleCI-Public/mcp-server-circleci",
60+
"homepage": "https://circleci.com",
61+
"documentation": "https://circleci.com/docs/guides/toolkit/using-the-circleci-mcp-server/"
62+
},
63+
"platforms": [
64+
"all"
65+
],
66+
"capabilities": {
67+
"tools": true,
68+
"resources": false,
69+
"prompts": false,
70+
"read_only_mode": false
71+
}
72+
}

‎servers/com.circleci-mcp-npx.json‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "com.circleci-mcp-npx",
4+
"name": "CircleCI (npx)",
5+
"alias": "circleci",
6+
"description": "Manage CircleCI pipelines, jobs, and workflows. Trigger builds, view job logs, analyze test results, and debug failed pipelines.",
7+
"icon": "https://avatars.githubusercontent.com/u/26607840?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"developer-tools"
11+
],
12+
"tags": [
13+
"circleci",
14+
"ci-cd",
15+
"pipelines",
16+
"builds",
17+
"testing",
18+
"deployment"
19+
],
20+
"transport": {
21+
"type": "stdio",
22+
"command": "npx",
23+
"args": [
24+
"-y",
25+
"@circleci/mcp-server-circleci"
26+
],
27+
"env": {
28+
"CIRCLECI_TOKEN": "${input:CIRCLECI_TOKEN}"
29+
},
30+
"metadata": {
31+
"inputs": [
32+
{
33+
"id": "CIRCLECI_TOKEN",
34+
"label": "CircleCI API Token",
35+
"description": "Personal API token for CircleCI.",
36+
"type": "text",
37+
"required": true,
38+
"secret": true,
39+
"placeholder": "CCIPAT_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
40+
"obtain": {
41+
"url": "https://app.circleci.com/settings/user/tokens",
42+
"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",
43+
"button_label": "Create Token"
44+
}
45+
}
46+
]
47+
}
48+
},
49+
"auth": {
50+
"type": "api_key",
51+
"instructions": "Create a Personal API Token at https://app.circleci.com/settings/user/tokens"
52+
},
53+
"contributor": {
54+
"name": "CircleCI",
55+
"github": "CircleCI-Public",
56+
"url": "https://circleci.com"
57+
},
58+
"links": {
59+
"repository": "https://github.com/CircleCI-Public/mcp-server-circleci",
60+
"homepage": "https://circleci.com",
61+
"documentation": "https://circleci.com/docs/guides/toolkit/using-the-circleci-mcp-server/"
62+
},
63+
"platforms": [
64+
"all"
65+
],
66+
"capabilities": {
67+
"tools": true,
68+
"resources": false,
69+
"prompts": false,
70+
"read_only_mode": false
71+
}
72+
}

0 commit comments

Comments
 (0)