CircleCI

आधिकारिक

AI एजेंटों को CircleCI से बिल्ड विफलताओं को ठीक करने में सक्षम बनाएं।

GitHub
86

Circle CI MCP के साथ आप क्या कर सकते हैं?

  • Check the latest pipeline status — Ask for the status of the most recent pipeline on a branch using get_latest_pipeline_status.
  • Retrieve build failure logs — Get detailed step-by-step failure logs from a failed job or pipeline with get_build_failure_logs.
  • Identify flaky tests — Analyze test execution history to surface flaky tests in a project via find_flaky_tests.
  • Validate CircleCI config — Check your .circleci/config.yml for syntax and semantic errors using config_helper.
  • Find underused compute resources — Feed usage data into find_underused_resource_classes to spot jobs with low CPU/RAM utilization.
  • Trigger or rerun pipelines — Start a new pipeline with run_pipeline or rerun a workflow from a failed job using rerun_workflow.

दस्तावेज़

CircleCI MCP सर्वर

License: Apache 2.0 CircleCI npm

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) बड़े भाषा मॉडलों (LLMs) और बाहरी प्रणालियों के बीच संदर्भ प्रबंधित करने के लिए एक नया, मानकीकृत प्रोटोकॉल है। इस रिपॉजिटरी में, हम CircleCI के लिए एक MCP सर्वर प्रदान करते हैं।

अपने IDE को छोड़े बिना, प्राकृतिक भाषा का उपयोग करके CircleCI के साथ इंटरैक्ट करने के लिए Cursor, Windsurf, Copilot, Claude, या किसी भी MCP-संगत क्लाइंट का उपयोग करें।

उपकरण

उपकरणविवरण
analyze_diffउल्लंघनों के लिए कर्सर नियमों के विरुद्ध git अंतर का विश्लेषण करें
config_helperअपने CircleCI कॉन्फ़िगरेशन को मान्य करें और मार्गदर्शन प्राप्त करें
create_prompt_templateAI अनुप्रयोगों के लिए संरचित प्रॉम्प्ट टेम्पलेट तैयार करें
download_usage_api_dataCircleCI उपयोग API से उपयोग डेटा डाउनलोड करें
find_flaky_testsपरीक्षण निष्पादन इतिहास का विश्लेषण करके अस्थिर परीक्षणों की पहचान करें
find_underused_resource_classesकम उपयोग किए गए कंप्यूट संसाधनों वाली जॉब खोजें
get_build_failure_logsCircleCI बिल्ड से विस्तृत विफलता लॉग प्राप्त करें
get_job_test_resultsCircleCI जॉब के लिए परीक्षण मेटाडेटा और परिणाम प्राप्त करें
get_latest_pipeline_statusकिसी शाखा के लिए नवीनतम पाइपलाइन की स्थिति प्राप्त करें
list_artifactsCircleCI जॉब द्वारा उत्पादित आर्टिफैक्ट सूचीबद्ध करें
list_component_versionsCircleCI घटक के सभी संस्करण सूचीबद्ध करें
list_followed_projectsआपके द्वारा अनुसरण किए जा रहे सभी CircleCI प्रोजेक्ट सूचीबद्ध करें
recommend_prompt_template_testsप्रॉम्प्ट टेम्पलेट के लिए परीक्षण मामले तैयार करें
rerun_workflowकिसी वर्कफ़्लो को शुरू से या विफल जॉब से पुनः चलाएँ
run_evaluation_testsCircleCI पाइपलाइन पर मूल्यांकन परीक्षण चलाएँ
run_pipelineचलाने के लिए एक पाइपलाइन ट्रिगर करें
run_rollback_pipelineकिसी प्रोजेक्ट के लिए रोलबैक ट्रिगर करें

स्थापना

टीम / केंद्रीकृत परिनियोजन: प्रति-डेवलपर या साझा CircleCI टोकन के साथ अपने संगठन (Kubernetes, Docker, आदि) के लिए एक साझा दूरस्थ सर्वर चलाने हेतु, स्व-प्रबंधित दूरस्थ MCP सर्वर देखें।

Cursor

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

अपने Cursor MCP कॉन्फ़िग में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

CIRCLECI_BASE_URL वैकल्पिक है — केवल ऑन-प्रिमाइसेस ग्राहकों के लिए आवश्यक। MAX_MCP_OUTPUT_LENGTH वैकल्पिक है — MCP प्रतिक्रियाओं के लिए अधिकतम आउटपुट लंबाई (डिफ़ॉल्ट: 50000)।

स्थानीय MCP सर्वर में Docker का उपयोग करना

अपने Cursor MCP कॉन्फ़िग में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। प्रति-उपयोगकर्ता क्लाइंट कॉन्फ़िगरेशन का उपयोग करें और इसे अपने Cursor MCP कॉन्फ़िग (Cursor Settings → MCP) में जोड़ें।

VS Code

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

अपने प्रोजेक्ट में .vscode/mcp.json में निम्नलिखित जोड़ें:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

💡 पहले सर्वर प्रारंभ पर इनपुट मांगे जाते हैं, फिर VS Code द्वारा सुरक्षित रूप से संग्रहीत किए जाते हैं।

स्थानीय MCP सर्वर में Docker का उपयोग करना

अपने प्रोजेक्ट में .vscode/mcp.json में निम्नलिखित जोड़ें:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "circleci-base-url",
      "description": "CircleCI Base URL",
      "default": "https://circleci.com"
    }
  ],
  "servers": {
    "circleci-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "${input:circleci-token}",
        "CIRCLECI_BASE_URL": "${input:circleci-base-url}"
      }
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। .vscode/mcp.json में प्रति-उपयोगकर्ता क्लाइंट कॉन्फ़िगरेशन का उपयोग करें।

Claude Desktop

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

अपने claude_desktop_config.json में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

स्थानीय MCP सर्वर में Docker का उपयोग करना

अपने claude_desktop_config.json में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। Claude Desktop और CLI क्लाइंट में दिखाए अनुसार एक रैपर स्क्रिप्ट बनाएँ, फिर अपने claude_desktop_config.json को उस पर इंगित करें।

अपनी कॉन्फ़िग फ़ाइल ढूँढने या बनाने के लिए, Claude Desktop सेटिंग्स खोलें, बाएँ साइडबार में Developer पर क्लिक करें, फिर Edit Config पर क्लिक करें। कॉन्फ़िग फ़ाइल यहाँ स्थित है:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

अधिक जानकारी के लिए: https://modelcontextprotocol.io/quickstart/user

Claude Code

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci@latest

स्थानीय MCP सर्वर में Docker का उपयोग करना

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com -- docker run --rm -i -e CIRCLECI_TOKEN -e CIRCLECI_BASE_URL circleci/mcp-server-circleci

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर और वहाँ Claude Code क्लाइंट सेटअप देखें।

Windsurf

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

अपने Windsurf mcp_config.json में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "npx",
      "args": ["-y", "@circleci/mcp-server-circleci@latest"],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

स्थानीय MCP सर्वर में Docker का उपयोग करना

अपने Windsurf mcp_config.json में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "circleci-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "CIRCLECI_TOKEN",
        "-e",
        "CIRCLECI_BASE_URL",
        "-e",
        "MAX_MCP_OUTPUT_LENGTH",
        "circleci/mcp-server-circleci"
      ],
      "env": {
        "CIRCLECI_TOKEN": "your-circleci-token",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      }
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। अपने Windsurf mcp_config.json में प्रति-उपयोगकर्ता क्लाइंट कॉन्फ़िगरेशन का उपयोग करें।

अधिक जानकारी के लिए: https://docs.windsurf.com/windsurf/mcp

Amazon Q Developer CLI

पूर्वापेक्षाएँ:

Amazon Q Developer में MCP क्लाइंट कॉन्फ़िगरेशन mcp.json नामक फ़ाइल में JSON प्रारूप में संग्रहीत होता है। कॉन्फ़िगरेशन के दो स्तर समर्थित हैं:

  • वैश्विक: ~/.aws/amazonq/mcp.json — सभी कार्यस्थानों पर लागू होता है
  • कार्यस्थान: .amazonq/mcp.json — वर्तमान कार्यस्थान के लिए विशिष्ट

यदि दोनों फ़ाइलें मौजूद हैं, तो उनकी सामग्री विलय हो जाती है। विरोध की स्थिति में, कार्यस्थान कॉन्फ़िग को प्राथमिकता दी जाती है।

स्थानीय MCP सर्वर में NPX का उपयोग करना

~/.aws/amazonq/mcp.json संपादित करें या निम्नलिखित के साथ .amazonq/mcp.json बनाएँ:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। Claude Desktop और CLI क्लाइंट में दिखाए अनुसार एक रैपर स्क्रिप्ट का उपयोग करें, फिर इसे q mcp add के साथ पंजीकृत करें।

Amazon Q Developer IDE में

पूर्वापेक्षाएँ:

स्थानीय MCP सर्वर में NPX का उपयोग करना

~/.aws/amazonq/mcp.json संपादित करें या निम्नलिखित के साथ .amazonq/mcp.json बनाएँ:

{
  "mcpServers": {
    "circleci-local": {
      "command": "npx",
      "args": [
        "-y",
        "@circleci/mcp-server-circleci@latest"
      ],
      "env": {
        "CIRCLECI_TOKEN": "YOUR_CIRCLECI_TOKEN",
        "CIRCLECI_BASE_URL": "https://circleci.com",
        "MAX_MCP_OUTPUT_LENGTH": "50000"
      },
      "timeout": 60000
    }
  }
}

स्व-प्रबंधित दूरस्थ MCP सर्वर का उपयोग करना

स्व-प्रबंधित दूरस्थ MCP सर्वर देखें। Claude Desktop और CLI क्लाइंट में दिखाए अनुसार एक रैपर स्क्रिप्ट का उपयोग करें, फिर इसे MCP कॉन्फ़िगरेशन UI के माध्यम से जोड़ें:

  1. MCP कॉन्फ़िगरेशन UI तक पहुँचें
  2. + चिह्न चुनें
  3. कार्यक्षेत्र चुनें: वैश्विक या स्थानीय
  4. एक नाम दर्ज करें (जैसे circleci-remote-mcp)
  5. परिवहन प्रोटोकॉल चुनें: stdio
  6. अपनी स्क्रिप्ट का कमांड पथ दर्ज करें
  7. Save पर क्लिक करें
Smithery

Smithery के माध्यम से Claude Desktop के लिए CircleCI MCP सर्वर स्वचालित रूप से स्थापित करने हेतु:

npx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude

स्व-प्रबंधित दूरस्थ MCP सर्वर

MCP सर्वर को केंद्रीय रूप से चलाएँ (उदाहरण के लिए Kubernetes या Docker पर) ताकि आपकी टीम एक परिनियोजन साझा करे। चुनें कि डेवलपर कैसे प्रमाणित करें:

परिनियोजन मोड चुनें

मोडकब उपयोग करेंसर्वर सेटअपक्लाइंट सेटअपCircleCI ऑडिट ट्रेल
प्रति-उपयोगकर्ता टोकन (अनुशंसित)SSO-समर्थित व्यक्तिगत API टोकन वाली टीमेंREQUIRE_REQUEST_TOKEN=true, कोई सर्वर PAT नहींप्रत्येक डेवलपर अपना PAT अग्रेषित करता हैप्रति डेवलपर
साझा टोकन (अंतरिम)त्वरित रोलआउट, एकल सेवा पहचान ठीक हैसर्वर पर CIRCLECI_TOKEN, REQUIRE_REQUEST_TOKEN=false (स्पष्ट ऑप्ट-आउट)किसी प्रमाणीकरण हेडर की आवश्यकता नहींएकल साझा पहचान

सुरक्षा: दूरस्थ मोड में अनुरोध प्रमाणीकरण डिफ़ॉल्ट रूप से चालू है। साझा-टोकन मोड इसे अक्षम करता है (REQUIRE_REQUEST_TOKEN=false), जिससे हर कॉलर बिना क्रेडेंशियल के सर्वर की CIRCLECI_TOKEN पहचान के रूप में कार्य कर सकता है। इसे केवल उस नेटवर्क पर सक्षम करें जिस पर आप पूरी तरह भरोसा करते हैं, और अन्यथा प्रति-उपयोगकर्ता टोकन को प्राथमिकता दें। इन्ग्रेस पर TLS समाप्त करना एन्क्रिप्शन प्रदान करता है, प्रमाणीकरण नहीं।

1. सर्वर परिनियोजित करें

दोनों मोड दूरस्थ HTTP मोड (start=remote) का उपयोग करते हैं। पोर्ट 8000 (या अपना चुना हुआ पोर्ट) प्रकाशित करें।

प्रति-उपयोगकर्ता टोकन (अनुशंसित) — लोकलहोस्ट से mcp-remote के माध्यम से एक्सेस किया गया:

docker run --rm -p 8000:8000 \
  -e start=remote \
  -e port=8000 \
  -e REQUIRE_REQUEST_TOKEN=true \
  circleci/mcp-server-circleci

प्रति-उपयोगकर्ता टोकन (अनुशंसित) — सार्वजनिक होस्टनाम से mcp-remote के माध्यम से एक्सेस किया गया:

docker run --rm -p 8000:8000 \
  -e start=remote \
  -e port=8000 \
  -e REQUIRE_REQUEST_TOKEN=true \
  -e MCP_ALLOWED_HOSTS=my-mcp.example.com \
  circleci/mcp-server-circleci

साझा टोकन (अंतरिम) — सार्वजनिक होस्टनाम से mcp-remote के माध्यम से एक्सेस किया गया:

docker run --rm -p 8000:8000 \
  -e start=remote \
  -e port=8000 \
  -e CIRCLECI_TOKEN=your-shared-circleci-pat \
  -e REQUIRE_REQUEST_TOKEN=false \
  -e MCP_ALLOWED_HOSTS=my-mcp.example.com \
  circleci/mcp-server-circleci

एन्वायरनमेंट वेरिएबल:

वेरिएबलविवरण
start=remotestdio के बजाय HTTP+SSE MCP सर्वर प्रारंभ करता है
portकंटेनर के अंदर सुनने का पोर्ट (डिफ़ॉल्ट: 8000)
REQUIRE_REQUEST_TOKENAuthorization: Bearer या Circle-Token हेडर के बिना अनुरोध अस्वीकार करें। डिफ़ॉल्ट रूप से आवश्यक; अप्रमाणित अनुरोधों की अनुमति देने के लिए REQUIRE_REQUEST_TOKEN=false सेट करें (साझा-टोकन मोड)
CIRCLECI_TOKENजब प्रति-उपयोगकर्ता हेडर नहीं भेजे जाते हैं तो सभी अनुरोधों के लिए साझा फ़ॉलबैक PAT
CIRCLECI_BASE_URLवैकल्पिक — केवल ऑन-प्रिम के लिए आवश्यक (डिफ़ॉल्ट: https://circleci.com)
DISABLE_TELEMETRY=trueउपयोग मेट्रिक्स निर्यात से ऑप्ट आउट करें
MCP_ALLOWED_HOSTSअनुमति देने के लिए अतिरिक्त Host हेडर मानों की अल्पविराम-पृथक सूची (जैसे my-mcp.example.com,my-mcp.example.com:443)। लूपबैक होस्टनाम हमेशा अनुमत हैं। किसी भी गैर-लूपबैक परिनियोजन के लिए आवश्यक।
MCP_ALLOWED_ORIGINSअनुमति देने के लिए अतिरिक्त Origin हेडर मानों की अल्पविराम-पृथक सूची (जैसे https://my-app.example.com)। लूपबैक ओरिजिन हमेशा अनुमत हैं। केवल तब आवश्यक जब कोई ब्राउज़र सीधे इस सर्वर तक पहुँचता है (mcp-remote के माध्यम से नहीं)।
MCP_BIND_HOSTबाइंड करने के लिए नेटवर्क इंटरफ़ेस (डिफ़ॉल्ट: 0.0.0.0)। केवल लूपबैक तक सीमित करने के लिए 127.0.0.1 पर सेट करें (Docker -p पोर्ट मैपिंग के साथ संगत नहीं)।

DNS-रीबाइंडिंग सुरक्षा: रिमोट ट्रांसपोर्ट हर /mcp अनुरोध पर Host हेडर को मान्य करता है। डिफ़ॉल्ट रूप से केवल लूपबैक पते (localhost, 127.0.0.1, [::1]) स्वीकार किए जाते हैं। सार्वजनिक परिनियोजनों को MCP_ALLOWED_HOSTS को उस होस्टनाम पर सेट करना होगा जिसका उपयोग क्लाइंट करते हैं, अन्यथा सभी /mcp अनुरोधों को 403 Forbidden प्राप्त होगा। /ping हेल्थ-चेक एंडपॉइंट सुरक्षित नहीं है ताकि Host की परवाह किए बिना लोड-बैलेंसर जांच काम करती रहें।

Origin हेडर (ब्राउज़रों द्वारा भेजा गया) भी मौजूद होने पर मान्य किया जाता है। mcp-remote जैसे गैर-ब्राउज़र क्लाइंट कभी भी Origin नहीं भेजते हैं, इसलिए वे इस जांच से अप्रभावित रहते हैं।

रिवर्स प्रॉक्सी के पीछे: यदि आपका प्रॉक्सी Host को बैकएंड पते (nginx का डिफ़ॉल्ट) पर पुनर्लेखित करता है, तो मूल होस्टनाम को पास करने के लिए proxy_set_header Host $host; जोड़ें, फिर MCP_ALLOWED_HOSTS को उस सार्वजनिक होस्टनाम पर सेट करें। वैकल्पिक रूप से, MCP_ALLOWED_HOSTS को उस होस्टनाम पर सेट करें जिसे प्रॉक्सी अग्रेषित करता है।

सर्वर प्रति-अनुरोध टोकन निम्नलिखित के माध्यम से स्वीकार करता है:

  • Authorization: Bearer <circleci-pat>
  • Circle-Token: <circleci-pat>

यदि कोई क्लाइंट हेडर टोकन भेजता है, तो यह सर्वर पर CIRCLECI_TOKEN पर प्राथमिकता लेता है।

अनुरोध के दौरान रिकॉर्ड किए गए टेलीमेट्री मेट्रिक्स उसी टोकन का उपयोग करके निर्यात किए जाते हैं जो उस अनुरोध का है।

2. क्लाइंट कॉन्फ़िगर करें

अधिकांश MCP क्लाइंट केवल स्थानीय (stdio) प्रक्रियाओं का समर्थन करते हैं। उन्हें अपने रिमोट सर्वर से जोड़ने के लिए mcp-remote का उपयोग करें, जो एक तृतीय-पक्ष stdio-to-HTTP ब्रिज है।

URL योजना: स्थानीय परीक्षण के लिए --allow-http के साथ http://localhost:8000/mcp का उपयोग करें। उत्पादन में, अपने इन्ग्रेस/लोड बैलेंसर पर TLS समाप्त करें और --allow-http के बिना https://your-host/mcp का उपयोग करें।

विंडोज: --header मानों में कोलन के आसपास रिक्त स्थान से बचें। पूर्ण Bearer <token> मान को एक पर्यावरण चर में रखें।

सुरक्षा: उदाहरण सुविधा के लिए npx का उपयोग करते हैं। उत्पादन या टीम रोलआउट के लिए, अपने MCP कॉन्फ़िग में एक विशिष्ट संस्करण पिन करें (उदाहरण के लिए mcp-remote के बजाय mcp-remote@0.1.38)। 0.1.16 से नीचे के संस्करणों का उपयोग न करें (CVE-2025-6514)।

क्लाइंट कॉन्फ़िगरेशन: प्रति-उपयोगकर्ता टोकन

प्रत्येक डेवलपर प्रत्येक अनुरोध पर अपना स्वयं का CircleCI व्यक्तिगत API टोकन अग्रेषित करता है:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    }
  ],
  "mcpServers": {
    "circleci-mcp-server-remote": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8000/mcp",
        "--allow-http",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ${input:circleci-token}"
      }
    }
  }
}

http://localhost:8000/mcp को अपनी टीम के सर्वर URL से बदलें। Cursor और VS Code ${input:...} संकेतों का समर्थन करते हैं; अन्य क्लाइंट सीधे AUTH_HEADER सेट कर सकते हैं।

क्लाइंट कॉन्फ़िगरेशन: साझा टोकन

जब सर्वर में CIRCLECI_TOKEN सेट हो और इसे REQUIRE_REQUEST_TOKEN=false के साथ प्रारंभ किया गया हो (अनुरोध प्रमाणीकरण डिफ़ॉल्ट रूप से चालू है और इसे स्पष्ट रूप से अक्षम किया जाना चाहिए), क्लाइंट को टोकन भेजने की आवश्यकता नहीं है:

{
  "mcpServers": {
    "circleci-mcp-server-remote": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:8000/mcp",
        "--allow-http"
      ]
    }
  }
}

Claude डेस्कटॉप और CLI क्लाइंट

एक रैपर स्क्रिप्ट बनाएँ (जैसे circleci-remote-mcp.sh):

#!/bin/bash
export AUTH_HEADER="Bearer your-circleci-token"
npx mcp-remote http://localhost:8000/mcp --allow-http --header "Authorization:${AUTH_HEADER}"

इसे निष्पादन योग्य बनाएँ (chmod +x circleci-remote-mcp.sh), फिर इसे अपने MCP कॉन्फ़िग से संदर्भित करें:

{
  "mcpServers": {
    "circleci-remote-mcp-server": {
      "command": "/full/path/to/circleci-remote-mcp.sh"
    }
  }
}

Claude कोड

claude mcp add circleci-mcp-server \
  -e AUTH_HEADER="Bearer your-circleci-token" \
  -- npx mcp-remote http://localhost:8000/mcp --allow-http --header "Authorization:${AUTH_HEADER}"

साझा-टोकन सर्वर का उपयोग करते समय --header और AUTH_HEADER को छोड़ दें।

3. परिनियोजन सत्यापित करें

# Health check (no auth required)
curl http://localhost:8000/ping

# Should return 401 when REQUIRE_REQUEST_TOKEN=true and no token is sent
curl -s -o /dev/null -w "%{http_code}\n" -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# Should return 200 with a valid Bearer token and MCP Accept headers
curl -s -o /dev/null -w "%{http_code}\n" -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer your-circleci-pat" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

डेमो

इसे कार्य करते हुए देखें

उदाहरण: "मेरी शाखा पर नवीनतम विफल पाइपलाइन खोजें और लॉग प्राप्त करें" — अधिक उदाहरणों के लिए विकी देखें।

https://github.com/user-attachments/assets/3c765985-8827-442a-a8dc-5069e01edb74

उपकरण विवरण

analyze_diff

नियम उल्लंघनों की पहचान करने के लिए कर्सर नियमों के विरुद्ध git अंतर का विश्लेषण करता है।

प्रदान करें:

  • Git अंतर सामग्री (जैसे git diff --cached, git diff HEAD)
  • .cursorrules या .cursor/rules से रिपॉजिटरी नियम

विश्वास स्कोर और स्पष्टीकरण के साथ विस्तृत उल्लंघन रिपोर्ट लौटाता है।

इसके लिए उपयोगी:

  • प्री-कमिट कोड गुणवत्ता जाँच
  • टीम कोडिंग मानकों के साथ स्थिरता सुनिश्चित करना
  • कोड समीक्षा से पहले नियम उल्लंघन पकड़ना
config_helper

मार्गदर्शन और सत्यापन प्रदान करके CircleCI कॉन्फ़िगरेशन कार्यों में सहायता करता है।

  • सिंटैक्स और सिमेंटिक त्रुटियों के लिए आपके .circleci/config.yml को मान्य करता है
  • विस्तृत सत्यापन परिणाम और कॉन्फ़िगरेशन अनुशंसाएँ प्रदान करता है
  • उदाहरण: "मेरे CircleCI कॉन्फ़िग को मान्य करें"
create_prompt_template

सुविधा आवश्यकताओं के आधार पर AI-सक्षम अनुप्रयोगों के लिए संरचित प्रॉम्प्ट टेम्प्लेट उत्पन्न करता है।

  • उपयोगकर्ता की आवश्यकताओं को अनुकूलित प्रॉम्प्ट टेम्प्लेट में बदलता है
  • एक संरचित टेम्प्लेट और आवश्यक इनपुट पैरामीटर को परिभाषित करने वाला एक संदर्भ स्कीमा लौटाता है
  • उदाहरण: "उम्र और विषय के अनुसार सोने के समय की कहानियाँ उत्पन्न करने के लिए एक प्रॉम्प्ट टेम्प्लेट बनाएँ"
download_usage_api_data

किसी दिए गए संगठन के लिए CircleCI उपयोग API से उपयोग डेटा डाउनलोड करता है। लचीली दिनांक इनपुट स्वीकार करता है (जैसे, "मार्च 2025" या "पिछला महीना")। केवल-क्लाउड सुविधा।

विकल्प 1: प्रदान करके एक नया निर्यात कार्य प्रारंभ करें:

  • orgId, startDate, endDate (अधिकतम 32 दिन), outputDir

विकल्प 2: प्रदान करके किसी मौजूदा निर्यात कार्य की जाँच/डाउनलोड करें:

  • orgId, jobId, outputDir

निर्दिष्ट समय सीमा के लिए CircleCI उपयोग डेटा के साथ एक CSV फ़ाइल लौटाता है।

[!NOTE] लागत अनुकूलन विश्लेषण के लिए उपयोग डेटा को find_underused_resource_classes उपकरण में फीड किया जा सकता है।

find_flaky_tests

परीक्षण निष्पादन इतिहास का विश्लेषण करके आपके CircleCI प्रोजेक्ट में अस्थिर परीक्षणों की पहचान करता है। CircleCI में अस्थिर परीक्षण पहचान सुविधा का लाभ उठाता है।

इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग का उपयोग करना (अनुशंसित):

    • अपने प्रोजेक्ट प्राप्त करने के लिए पहले list_followed_projects का उपयोग करें, फिर:
    • उदाहरण: "मेरे-प्रोजेक्ट के लिए अस्थिर परीक्षण प्राप्त करें"

  2. CircleCI प्रोजेक्ट URL का उपयोग करना:

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करना:

    • कार्यक्षेत्र रूट और git रिमोट URL प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है
    • उदाहरण: "मेरे वर्तमान प्रोजेक्ट में अस्थिर परीक्षण खोजें"

आउटपुट मोड:

  • पाठ (डिफ़ॉल्ट): पाठ प्रारूप में अस्थिर परीक्षण विवरण लौटाता है
  • फ़ाइल (FILE_OUTPUT_DIRECTORY env var की आवश्यकता है): अस्थिर परीक्षण विवरण के साथ एक निर्देशिका बनाता है
find_underused_resource_classes

किसी दिए गए सीमा (डिफ़ॉल्ट: 40%) से नीचे औसत या अधिकतम CPU/RAM उपयोग वाले कार्यों को खोजने के लिए CircleCI उपयोग डेटा CSV फ़ाइल का विश्लेषण करता है।

download_usage_api_data से प्राप्त एक CSV फ़ाइल प्रदान करें।

प्रोजेक्ट और वर्कफ़्लो द्वारा व्यवस्थित कम उपयोग वाले कार्यों की एक मार्कडाउन सूची लौटाता है — लागत अनुकूलन के अवसरों की पहचान करने के लिए उपयोगी।

get_build_failure_logs

CircleCI बिल्ड से विस्तृत विफलता लॉग प्राप्त करता है। इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करना (अनुशंसित):

    • अपने प्रोजेक्ट प्राप्त करने के लिए पहले list_followed_projects का उपयोग करें, फिर:
    • उदाहरण: "मुख्य शाखा पर मेरे-प्रोजेक्ट के लिए बिल्ड विफलताएँ प्राप्त करें"

  2. CircleCI URL का उपयोग करना:

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करना:

    • कार्यक्षेत्र रूट, git रिमोट URL और शाखा का नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है
    • उदाहरण: "मेरी वर्तमान शाखा पर नवीनतम विफल पाइपलाइन खोजें"

उपकरण स्वरूपित लॉग लौटाता है जिनमें शामिल हैं:

  • कार्य के नाम
  • चरण-दर-चरण निष्पादन विवरण
  • विफलता संदेश और संदर्भ
get_job_test_results

CircleCI कार्यों के लिए परीक्षण मेटाडेटा प्राप्त करता है, जिससे आप अपने IDE को छोड़े बिना परीक्षण परिणामों का विश्लेषण कर सकते हैं। इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करना (अनुशंसित):

    • उदाहरण: "मुख्य शाखा पर मेरे-प्रोजेक्ट के लिए परीक्षण परिणाम प्राप्त करें"

  2. CircleCI URL का उपयोग करना:

    • कार्य URL: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789
    • वर्कफ़्लो URL: https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def
    • पाइपलाइन URL: https://app.circleci.com/pipelines/github/org/repo/123

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करना:

    • कार्यक्षेत्र रूट, git रिमोट URL और शाखा का नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है

उपकरण लौटाता है:

  • सभी परीक्षणों का सारांश (कुल, सफल, विफल)
  • विफल परीक्षणों पर विस्तृत जानकारी: नाम, वर्ग, फ़ाइल, त्रुटि संदेश, अवधि
  • समय के साथ सफल परीक्षणों की सूची
  • परीक्षण परिणाम के आधार पर फ़िल्टर करें

[!NOTE] परीक्षण मेटाडेटा आपके CircleCI कॉन्फ़िग में कॉन्फ़िगर किया जाना चाहिए। सेटअप निर्देशों के लिए परीक्षण डेटा एकत्र करें देखें।

get_latest_pipeline_status

किसी दी गई शाखा के लिए नवीनतम पाइपलाइन की स्थिति प्राप्त करता है। इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करना (अनुशंसित):

    • उदाहरण: "मुख्य शाखा पर मेरे-प्रोजेक्ट के लिए नवीनतम पाइपलाइन की स्थिति प्राप्त करें"

  2. CircleCI प्रोजेक्ट URL का उपयोग करना:

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करना:

    • कार्यक्षेत्र रूट, git रिमोट URL और शाखा का नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है

उदाहरण आउटपुट:

---
Workflow: build
Status: success
Duration: 5 minutes
Created: 4/20/2025, 10:15:30 AM
Stopped: 4/20/2025, 10:20:45 AM
---
Workflow: test
Status: running
Duration: unknown
Created: 4/20/2025, 10:21:00 AM
Stopped: in progress
list_artifacts

CircleCI कार्य द्वारा उत्पादित कलाकृतियों की सूची प्राप्त करता है। इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करना (अनुशंसित):

    • अपने प्रोजेक्ट प्राप्त करने के लिए पहले list_followed_projects का उपयोग करें, फिर:
    • उदाहरण: "मुख्य शाखा पर मेरे-प्रोजेक्ट के लिए कलाकृतियाँ सूचीबद्ध करें"

  2. CircleCI URL का उपयोग करना:

    • कार्य URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/789
    • वर्कफ़्लो URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def
    • पाइपलाइन URL: https://app.circleci.com/pipelines/gh/organization/project/123

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करना:

    • कार्यक्षेत्र रूट, git रिमोट URL और शाखा का नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है

इसके लिए उपयोगी:

  • बिल्ड कलाकृतियों (बायनेरिज़, रिपोर्ट, लॉग) के लिए डाउनलोड URL ढूँढना
  • यह जाँचना कि पाइपलाइन रन द्वारा कौन सी कलाकृतियाँ उत्पादित की गईं
list_component_versions

किसी परिवेश में किसी विशिष्ट CircleCI घटक के लिए सभी संस्करणों को सूचीबद्ध करता है। परिनियोजन स्थिति, कमिट जानकारी और टाइमस्टैम्प शामिल हैं।

यदि प्रदान नहीं किया गया है तो उपकरण आपको घटक और परिवेश का चयन करने के लिए संकेत देगा।

इसके लिए उपयोगी:

  • यह पहचानना कि वर्तमान में कौन सा संस्करण लाइव है
  • रोलबैक संचालन के लिए लक्ष्य संस्करणों का चयन करना
  • परिनियोजन विवरण प्राप्त करना (पाइपलाइन, वर्कफ़्लो, कार्य)
list_followed_projects

उन सभी प्रोजेक्ट्स को सूचीबद्ध करता है जिनका उपयोगकर्ता CircleCI पर अनुसरण कर रहा है।

  • आपके द्वारा एक्सेस किए जा सकने वाले सभी प्रोजेक्ट्स को उनके projectSlug के साथ दिखाता है
  • उदाहरण: "मेरे CircleCI प्रोजेक्ट्स सूचीबद्ध करें"

उदाहरण आउटपुट:

Projects followed:
1. my-project (projectSlug: gh/organization/my-project)
2. another-project (projectSlug: gh/organization/another-project)

[!NOTE] projectSlug (प्रोजेक्ट नाम नहीं) कई अन्य CircleCI उपकरणों के लिए आवश्यक है।

recommend_prompt_template_tests

यह सुनिश्चित करने के लिए प्रॉम्प्ट टेम्प्लेट के लिए परीक्षण मामले उत्पन्न करता है कि वे अपेक्षित परिणाम उत्पन्न करें।

  • आपके प्रॉम्प्ट टेम्पलेट और संदर्भ स्कीमा के आधार पर विविध परीक्षण परिदृश्य बनाता है
  • विभिन्न पैरामीटर संयोजनों के साथ अनुशंसित परीक्षण मामलों की एक सरणी लौटाता है
  • उदाहरण: "मेरे सोने के समय की कहानी प्रॉम्प्ट टेम्पलेट के लिए परीक्षण उत्पन्न करें"
rerun_workflow

किसी वर्कफ़्लो को उसकी शुरुआत से या विफल कार्य से पुनः चलाता है।

नवनिर्मित वर्कफ़्लो की आईडी और उसकी निगरानी के लिए एक लिंक लौटाता है।

run_evaluation_tests

CircleCI पाइपलाइन पर मूल्यांकन परीक्षण (जिन्हें "प्रॉम्प्ट टेस्ट" भी कहा जाता है) चलाता है। एक उपयुक्त CircleCI कॉन्फ़िगरेशन उत्पन्न करता है और इसका उपयोग करके एक पाइपलाइन ट्रिगर करता है।

इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करके (अनुशंसित):

    • अपने प्रोजेक्ट प्राप्त करने के लिए पहले list_followed_projects का उपयोग करें, फिर:
    • उदाहरण: "मुख्य शाखा पर my-project के लिए मूल्यांकन परीक्षण चलाएँ"

  2. CircleCI URL का उपयोग करके:

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करके:

    • कार्यक्षेत्र रूट, गिट रिमोट URL और शाखा नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है

उपकरण प्रॉम्प्ट टेम्पलेट फ़ाइलें स्वीकार करता है और ट्रिगर की गई पाइपलाइन की निगरानी के लिए एक URL लौटाता है।

[!NOTE] यदि प्रोजेक्ट में एकाधिक पाइपलाइन परिभाषाएँ हैं, तो उपकरण आपको चुनने के लिए उपलब्ध पाइपलाइनों की एक सूची लौटाएगा।

run_pipeline

चलाने के लिए एक पाइपलाइन ट्रिगर करता है। इस उपकरण का उपयोग तीन तरीकों से किया जा सकता है:

  1. प्रोजेक्ट स्लग और शाखा का उपयोग करके (अनुशंसित):

    • उदाहरण: "मुख्य शाखा पर my-project के लिए पाइपलाइन चलाएँ"

  2. CircleCI URL का उपयोग करके:

    • पाइपलाइन URL, वर्कफ़्लो URL, कार्य URL, या शाखा सहित प्रोजेक्ट URL
    • उदाहरण: "https://app.circleci.com/pipelines/github/org/repo/123 के लिए पाइपलाइन चलाएँ"

  3. स्थानीय प्रोजेक्ट संदर्भ का उपयोग करके:

    • कार्यक्षेत्र रूट, गिट रिमोट URL और शाखा नाम प्रदान करके आपके स्थानीय कार्यक्षेत्र से काम करता है

उपकरण पाइपलाइन निष्पादन की निगरानी के लिए एक लिंक लौटाता है।

run_rollback_pipeline

CircleCI प्रोजेक्ट के लिए रोलबैक ट्रिगर करता है। उपकरण आपको निम्नलिखित के माध्यम से सहभागी रूप से मार्गदर्शन करता है:

  1. प्रोजेक्ट चयन — चुनने के लिए अनुसरण किए गए प्रोजेक्ट सूचीबद्ध करता है
  2. वातावरण चयन — उपलब्ध वातावरण सूचीबद्ध करता है (यदि केवल एक है तो स्वतः चयन)
  3. घटक चयन — उपलब्ध घटक सूचीबद्ध करता है (यदि केवल एक है तो स्वतः चयन)
  4. संस्करण चयन — उपलब्ध संस्करण प्रदर्शित करता है; आप रोलबैक के लिए लक्ष्य चुनते हैं
  5. रोलबैक मोड का पता लगाना — जाँचता है कि रोलबैक पाइपलाइन कॉन्फ़िगर है या नहीं
  6. रोलबैक निष्पादित करें — दो विकल्प:
    • पाइपलाइन रोलबैक: रोलबैक पाइपलाइन ट्रिगर करता है
    • वर्कफ़्लो पुनर्चालन: अपनी वर्कफ़्लो आईडी का उपयोग करके पिछले वर्कफ़्लो को पुनः चलाता है
  7. पुष्टि — निष्पादन से पहले सारांशित और पुष्टि करता है

समस्या निवारण

त्वरित समाधान

सबसे आम समस्याएँ:

  1. पैकेज कैश साफ़ करें:

    npx clear-npx-cache
npm cache clean --force

  2. नवीनतम संस्करण बाध्य करें: अपने कॉन्फ़िग में @latest जोड़ें:

    "args": ["-y", "@circleci/mcp-server-circleci@latest"]

  3. अपने IDE को पूरी तरह से पुनरारंभ करें (केवल विंडो पुनः लोड न करें)

प्रमाणीकरण संबंधी समस्याएँ
  • अमान्य टोकन त्रुटियाँ: व्यक्तिगत API टोकन में अपना CIRCLECI_TOKEN सत्यापित करें
  • अनुमति त्रुटियाँ: सुनिश्चित करें कि टोकन के पास आपके प्रोजेक्ट तक पढ़ने की पहुँच है
  • एनवायरनमेंट वेरिएबल लोड नहीं हो रहे: echo $CIRCLECI_TOKEN (Mac/Linux) या echo %CIRCLECI_TOKEN% (Windows) से परीक्षण करें
कनेक्शन और नेटवर्क संबंधी समस्याएँ
  • आधार URL: पुष्टि करें कि CIRCLECI_BASE_URL https://circleci.com है
  • कॉर्पोरेट नेटवर्क: यदि फ़ायरवॉल के पीछे हैं तो npm प्रॉक्सी सेटिंग्स कॉन्फ़िगर करें
  • फ़ायरवॉल अवरोधन: जाँचें कि क्या सुरक्षा सॉफ़्टवेयर पैकेज डाउनलोड को रोक रहा है
सिस्टम आवश्यकताएँ
  • Node.js संस्करण: node --version से सुनिश्चित करें >= 18.0.0
  • Node.js अपडेट करें: यदि संगतता समस्याएँ आ रही हैं तो नवीनतम LTS पर विचार करें
  • पैकेज प्रबंधक: सत्यापित करें कि npm/pnpm काम कर रहा है: npm --version
IDE-विशिष्ट समस्याएँ
  • कॉन्फ़िग फ़ाइल स्थान: अपने OS के लिए पथ की दोबारा जाँच करें
  • सिंटैक्स त्रुटियाँ: अपनी कॉन्फ़िग फ़ाइल में JSON सिंटैक्स मान्य करें
  • कंसोल लॉग: विशिष्ट त्रुटियों के लिए IDE डेवलपर कंसोल की जाँच करें
  • भिन्न IDE आज़माएँ: समस्या को अलग करने के लिए किसी अन्य समर्थित संपादक में परीक्षण करें
प्रक्रिया संबंधी समस्याएँ

हैंग हो रही प्रक्रियाएँ — मौजूदा MCP प्रक्रियाओं को समाप्त करें:

# Mac/Linux:
pkill -f "mcp-server-circleci"

# Windows:
taskkill /f /im node.exe

पोर्ट विरोध: यदि कनेक्शन अवरुद्ध लगता है तो अपने IDE को पुनरारंभ करें।

उन्नत डिबगिंग
  • सीधे पैकेज का परीक्षण करें: npx @circleci/mcp-server-circleci@latest --help
  • विस्तृत लॉगिंग: DEBUG=* npx @circleci/mcp-server-circleci@latest
  • डॉकर फ़ॉलबैक: यदि npx लगातार विफल होता है तो डॉकर इंस्टॉलेशन आज़माएँ

अभी भी सहायता चाहिए?

  1. समान समस्याओं के लिए GitHub Issues देखें
  2. समस्या की रिपोर्ट करते समय अपना OS, Node संस्करण और IDE शामिल करें
  3. IDE कंसोल से प्रासंगिक त्रुटि संदेश साझा करें

टेलीमेट्री

सर्वर उपकरण उपयोग पर नज़र रखने के लिए OpenTelemetry मेट्रिक्स का समर्थन करता है। मेट्रिक्स तब तक निर्यात किए जाते हैं जब तक आप DISABLE_TELEMETRY=true सेट नहीं करते। दूरस्थ परिनियोजन पर, मेट्रिक्स अनुरोध के समान टोकन (प्रति-उपयोगकर्ता PAT या साझा सर्वर PAT) का उपयोग करते हैं।

मीट्रिकविवरण
circleci.mcp.tool.invocationsउपकरण आह्वान गणना
circleci.mcp.tool.duration_msमिलीसेकंड में निष्पादन समय
circleci.mcp.tool.errorsत्रुटि गणना

विकास

आरंभ करना

  1. रिपॉजिटरी क्लोन करें:

    git clone https://github.com/CircleCI-Public/mcp-server-circleci.git
cd mcp-server-circleci

  2. निर्भरताएँ स्थापित करें:

    pnpm install

  3. प्रोजेक्ट बनाएँ:

    pnpm build

डॉकर कंटेनर बनाना

आप स्थानीय रूप से डॉकर कंटेनर बना सकते हैं:

docker build -t circleci:mcp-server-circleci .

यह circleci:mcp-server-circleci के रूप में टैग की गई एक डॉकर छवि बनाएगा जिसका उपयोग आप किसी भी MCP क्लाइंट के साथ कर सकते हैं।

स्थानीय stdio मोड (एकल डेवलपर, क्लाइंट पर टोकन):

docker run --rm -i \
  -e CIRCLECI_TOKEN=your-circleci-token \
  -e CIRCLECI_BASE_URL=https://circleci.com \
  circleci/mcp-server-circleci

दूरस्थ मोड (एक टीम के लिए केंद्रीकृत सर्वर): स्व-प्रबंधित दूरस्थ MCP सर्वर देखें।

MCP इंस्पेक्टर के साथ विकास

MCP सर्वर पर पुनरावृत्ति करने का सबसे आसान तरीका MCP इंस्पेक्टर का उपयोग करना है। आप MCP इंस्पेक्टर के बारे में https://modelcontextprotocol.io/docs/tools/inspector पर अधिक जान सकते हैं

  1. विकास सर्वर प्रारंभ करें:

    pnpm watch # Keep this running in one terminal

  2. एक अलग टर्मिनल में, इंस्पेक्टर लॉन्च करें:

    pnpm inspector

  3. वातावरण कॉन्फ़िगर करें:

    • इंस्पेक्टर UI में एनवायरनमेंट वेरिएबल अनुभाग में अपना CIRCLECI_TOKEN जोड़ें
    • टोकन को आपके CircleCI प्रोजेक्ट तक पढ़ने की पहुँच की आवश्यकता है
    • वैकल्पिक रूप से अपना CircleCI आधार URL सेट करें (डिफ़ॉल्ट https://circleci.com है)

परीक्षण

  • परीक्षण सूट चलाएँ:

    pnpm test

  • विकास के दौरान वॉच मोड में परीक्षण चलाएँ:

    pnpm test:watch

अधिक विस्तृत योगदान दिशानिर्देशों के लिए, CONTRIBUTING.md देखें