[{"_1":2,"_378":-5,"_379":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_304":305},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_78":-5,"_79":40,"_29":80,"_221":222,"_303":205},"availableLocales",[28,40,46,52,58,64,71],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Mit diesem MCP-Server können Sie Cursor IDE oder einen beliebigen MCP-Client-fähigen Agenten verwenden, um mithilfe natürlicher Sprache Aufgaben mit CircleCI zu erledigen, z. B.: Suchen Sie die letzte fehlgeschlagene Pipeline in meinem Zweig und rufen Sie Protokolle ab.","name","mcp-server-circleci","readme","# CircleCI MCP-Server\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![npm](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\nModel Context Protocol (MCP) ist ein [neues, standardisiertes Protokoll](https://modelcontextprotocol.io/introduction) zur Verwaltung des Kontexts zwischen großen Sprachmodellen (LLMs) und externen Systemen. In diesem Repository stellen wir einen MCP-Server für [CircleCI](https://circleci.com) bereit.\n\nAuf diese Weise können Sie Cursor IDE, Windsurf, Copilot oder jeden MCP-unterstützten Client verwenden, um mithilfe natürlicher Sprache Dinge mit CircleCI zu erreichen, z. B.:\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## Anforderungen\n\n* CircleCI API-Token – Sie können einen über CircleCI generieren. [Erfahren Sie mehr](https://circleci.com/docs/managing-api-tokens/) oder [klicken Sie hier](https://app.circleci.com/settings/user/tokens) für schnellen Zugriff.\n\nFür die NPX-Installation:\n\n* pnpm-Paketmanager – [Mehr erfahren](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\nFür die Docker-Installation:\n\n* Docker – [Mehr erfahren](https://docs.docker.com/get-docker/)\n\n## Installation\n\n### Cursor\n\n#### Verwenden von NPX\n\nFügen Sie Ihrer Cursor-MCP-Konfiguration Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Verwenden von Docker\n\nFügen Sie Ihrer Cursor-MCP-Konfiguration Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### VS Code\n\n#### Verwenden von NPX\n\nSo installieren Sie den CircleCI MCP-Server für VS Code in `.vscode/mcp.json` :\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Verwenden von Docker\n\nSo installieren Sie den CircleCI MCP-Server für VS Code in `.vscode/mcp.json` mit Docker:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### Claude Desktop\n\n#### Verwenden von NPX\n\nFügen Sie Ihrer claude\\_desktop\\_config.json Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Verwenden von Docker\n\nFügen Sie Ihrer claude\\_desktop\\_config.json Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nUm diese Datei zu finden/erstellen, öffnen Sie zunächst die Claude-Desktop-Einstellungen. Klicken Sie dann links im Einstellungsbereich auf „Entwickler“ und anschließend auf „Konfiguration bearbeiten“.\n\nDadurch wird eine Konfigurationsdatei erstellt unter:\n\n* macOS: ~/Library/Application Support/Claude/claude\\_desktop\\_config.json\n* Windows: %APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\nWeitere Informationen zur Verwendung von MCP-Servern mit Claude Desktop finden Sie in der folgenden Anleitung: \n\n### Claude Code\n\n#### Verwenden von NPX\n\nFühren Sie nach der Installation von Claude Code den folgenden Befehl aus:\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Verwenden von Docker\n\nFühren Sie nach der Installation von Claude Code den folgenden Befehl aus:\n\n```bash\nclaude 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\n```\n\nWeitere Informationen zur Verwendung von MCP-Servern mit Claude Code finden Sie in der folgenden Anleitung: \n\n### Windsurf\n\n#### Verwenden von NPX\n\nFügen Sie Ihrer Windsurf-mcp\\_config.json Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Verwenden von Docker\n\nFügen Sie Ihrer Windsurf-mcp\\_config.json Folgendes hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nWeitere Informationen zur Verwendung von MCP-Servern mit Windsurf finden Sie in der folgenden Anleitung: \n\n### Installation über Smithery\n\nSo installieren Sie CircleCI MCP Server für Claude Desktop automatisch über [Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci) :\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# Merkmale\n\n## Unterstützte Tools\n\n* `get_build_failure_logs`\n\n Ruft detaillierte Fehlerprotokolle von CircleCI-Builds ab. Dieses Tool kann auf drei Arten verwendet werden:\n\n 1. Verwenden von Projekt-Slug und Branch (empfohlener Arbeitsablauf):\n\n * Listen Sie zunächst Ihre verfügbaren Projekte auf:\n * Verwenden Sie das Tool list\\_followed\\_projects, um Ihre Projekte zu erhalten\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n * Wählen Sie dann das Projekt aus, dem ein ProjektSlug zugeordnet ist\n * Beispiel: „Lasst uns mein Projekt verwenden“\n * Fordern Sie dann an, die Build-Fehlerprotokolle für einen bestimmten Zweig abzurufen:\n * Beispiel: „Build-Fehler für mein Projekt im Hauptzweig abrufen“\n\n 2. Verwenden von CircleCI-URLs:\n\n * Geben Sie die URL eines fehlgeschlagenen Jobs oder einer Pipeline direkt an\n * Beispiel: „Protokolle abrufen von “\n\n 3. Lokalen Projektkontext verwenden:\n\n * Funktioniert von Ihrem lokalen Arbeitsbereich aus, indem Folgendes bereitgestellt wird:\n * Stammpfad des Arbeitsbereichs\n * Git-Remote-URL\n * Filialname\n * Beispiel: „Suchen Sie die letzte fehlgeschlagene Pipeline in meinem aktuellen Zweig.“\n\n Das Tool gibt formatierte Protokolle zurück, darunter:\n\n * Jobnamen\n * Schrittweise Ausführungsdetails\n * Fehlermeldungen und Kontext\n\n Dies ist besonders nützlich für:\n\n * Debuggen fehlgeschlagener Builds\n * Analysieren von Testfehlern\n * Untersuchen von Bereitstellungsproblemen\n * Schneller Zugriff auf Build-Protokolle, ohne Ihre IDE zu verlassen\n\n* `find_flaky_tests`\n\n Identifiziert fehlerhafte Tests in Ihrem CircleCI-Projekt durch Analyse des Testausführungsverlaufs. Dies nutzt die hier beschriebene Funktion zur Erkennung fehlerhafter Tests: \n\n Dieses Tool kann auf drei Arten verwendet werden:\n\n 1. Verwenden von Project Slug (empfohlener Arbeitsablauf):\n\n * Listen Sie zunächst Ihre verfügbaren Projekte auf:\n * Verwenden Sie das Tool list\\_followed\\_projects, um Ihre Projekte zu erhalten\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n * Wählen Sie dann das Projekt aus, dem ein ProjektSlug zugeordnet ist\n * Beispiel: „Lasst uns mein Projekt verwenden“\n * Fordern Sie dann an, die fehlerhaften Tests abzurufen:\n * Beispiel: „Holen Sie sich fehlerhafte Tests für mein Projekt“\n\n 2. Verwenden der CircleCI-Projekt-URL:\n\n * Geben Sie die Projekt-URL direkt von CircleCI an\n * Beispiel: „Finden Sie fehlerhafte Tests in “\n\n 3. Lokalen Projektkontext verwenden:\n\n * Funktioniert von Ihrem lokalen Arbeitsbereich aus, indem Folgendes bereitgestellt wird:\n * Stammpfad des Arbeitsbereichs\n * Git-Remote-URL\n * Beispiel: „Finden Sie fehlerhafte Tests in meinem aktuellen Projekt.“\n\n Das Tool gibt detaillierte Informationen zu fehlerhaften Tests zurück, darunter:\n\n * Testnamen und Dateispeicherorte\n * Fehlermeldungen und Kontexte\n\n Dies hilft Ihnen:\n\n * Identifizieren Sie unzuverlässige Tests in Ihrer Testsuite\n * Erhalten Sie detaillierten Kontext zu Testfehlern\n * Treffen Sie datenbasierte Entscheidungen zur Testverbesserung\n\n* `get_latest_pipeline_status`\n\n Ruft den Status der neuesten Pipeline für einen bestimmten Zweig ab. Dieses Tool kann auf drei Arten verwendet werden:\n\n 1. Verwenden von Projekt-Slug und Branch (empfohlener Arbeitsablauf):\n\n * Listen Sie zunächst Ihre verfügbaren Projekte auf:\n * Verwenden Sie das Tool list\\_followed\\_projects, um Ihre Projekte zu erhalten\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n * Wählen Sie dann das Projekt aus, dem ein ProjektSlug zugeordnet ist\n * Beispiel: „Lasst uns mein Projekt verwenden“\n * Fordern Sie dann an, den neuesten Pipeline-Status für einen bestimmten Zweig abzurufen:\n * Beispiel: „Status der neuesten Pipeline für mein Projekt im Hauptzweig abrufen“\n\n 2. Verwenden der CircleCI-Projekt-URL:\n\n * Geben Sie die Projekt-URL direkt von CircleCI an\n * Beispiel: „Holen Sie sich den Status der neuesten Pipeline für “\n\n 3. Lokalen Projektkontext verwenden:\n\n * Funktioniert von Ihrem lokalen Arbeitsbereich aus, indem Folgendes bereitgestellt wird:\n * Stammpfad des Arbeitsbereichs\n * Git-Remote-URL\n * Filialname\n * Beispiel: „Status der neuesten Pipeline für mein aktuelles Projekt abrufen“\n\n Das Tool gibt einen formatierten Status der neuesten Pipeline zurück:\n\n * Workflow-Namen und ihr aktueller Status\n * Dauer jedes Workflows\n * Zeitstempel für Erstellung und Abschluss\n * Gesamtzustand der Pipeline\n\n Beispielausgabe:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n Dies ist besonders nützlich für:\n\n * Überprüfen des Status der neuesten Pipeline\n * Abrufen des Status der neuesten Pipeline für einen bestimmten Zweig\n * Schnelles Überprüfen des Status der neuesten Pipeline, ohne Ihre IDE zu verlassen\n\n* `get_job_test_results`\n\n Ruft Testmetadaten für CircleCI-Jobs ab und ermöglicht Ihnen die Analyse von Testergebnissen, ohne Ihre IDE zu verlassen. Dieses Tool kann auf drei Arten verwendet werden:\n\n 1. Verwenden von Projekt-Slug und Branch (empfohlener Arbeitsablauf):\n\n * Listen Sie zunächst Ihre verfügbaren Projekte auf:\n * Verwenden Sie das Tool list\\_followed\\_projects, um Ihre Projekte zu erhalten\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n * Wählen Sie dann das Projekt aus, dem ein ProjektSlug zugeordnet ist\n * Beispiel: „Lasst uns mein Projekt verwenden“\n * Fordern Sie dann an, die Testergebnisse für einen bestimmten Zweig abzurufen:\n * Beispiel: „Testergebnisse für mein Projekt im Hauptzweig abrufen“\n\n 2. Verwenden der CircleCI-URL:\n\n * Geben Sie eine CircleCI-URL in einem dieser Formate an:\n * Job-URL: \" \"\n * Workflow-URL: \" \"\n * Pipeline-URL: \" \"\n * Beispiel: „Testergebnisse abrufen für “\n\n 3. Lokalen Projektkontext verwenden:\n\n * Funktioniert von Ihrem lokalen Arbeitsbereich aus, indem Folgendes bereitgestellt wird:\n * Stammpfad des Arbeitsbereichs\n * Git-Remote-URL\n * Filialname\n * Beispiel: „Testergebnisse für mein aktuelles Projekt im Hauptzweig abrufen“\n\n Das Tool gibt detaillierte Informationen zu den Testergebnissen zurück:\n\n * Zusammenfassung aller Tests (Gesamt, Erfolgreich, Nicht bestanden)\n * Detaillierte Informationen zu fehlgeschlagenen Tests, einschließlich:\n * Testname und Klasse\n * Dateispeicherort\n * Fehlermeldungen\n * Laufzeit\n * Liste erfolgreicher Tests mit Zeitinformationen\n * Nach Testergebnissen filtern\n\n Dies ist besonders nützlich für:\n\n * Schnelle Analyse von Testfehlern ohne Besuch der CircleCI-Web-Benutzeroberfläche\n * Erkennen von Mustern bei Testfehlern\n * Finden langsamer Tests, die möglicherweise optimiert werden müssen\n * Überprüfen der Testabdeckung in Ihrem gesamten Projekt\n * Fehlerbehebung bei fehlerhaften Tests\n\n Hinweis: Das Tool erfordert, dass die Testmetadaten in Ihrer CircleCI-Konfiguration korrekt konfiguriert sind. Weitere Informationen zum Einrichten der Testmetadatenerfassung finden Sie unter: \n\n* `config_helper`\n\n Unterstützt CircleCI-Konfigurationsaufgaben durch Anleitung und Validierung. Dieses Tool hilft Ihnen:\n\n 1. CircleCI-Konfiguration validieren:\n * Überprüft Ihre .circleci/config.yml auf Syntax- und Semantikfehler\n * Beispiel: „Meine CircleCI-Konfiguration validieren“\n\n Das Tool bietet:\n\n * Detaillierte Validierungsergebnisse\n * Konfigurationsempfehlungen\n\n Dies hilft Ihnen:\n\n * Fangen Sie Konfigurationsfehler ab, bevor Sie pushen\n * Erfahren Sie mehr über die Best Practices für die CircleCI-Konfiguration\n * Beheben von Konfigurationsproblemen\n * CircleCI-Funktionen richtig implementieren\n\n* `create_prompt_template`\n\n Hilft bei der Erstellung strukturierter Eingabevorlagen für KI-gestützte Anwendungen basierend auf Funktionsanforderungen. Dieses Tool:\n\n 1. Wandelt Funktionsanforderungen in strukturierte Eingabeaufforderungen um:\n * Wandelt Benutzeranforderungen in optimierte Eingabevorlagen um\n * Beispiel: „Erstellen Sie eine Vorlage für die Erstellung von Gutenachtgeschichten nach Alter und Thema.“\n\n Das Tool bietet:\n\n * Eine strukturierte Eingabeaufforderungsvorlage\n * Ein Kontextschema, das die erforderlichen Eingabeparameter definiert\n\n Dies hilft Ihnen:\n\n * Erstellen Sie effektive Eingabeaufforderungen für KI-Anwendungen\n * Standardisieren Sie Eingabeparameter für konsistente Ergebnisse\n * Erstellen Sie robuste KI-gestützte Funktionen\n\n* `recommend_prompt_template_tests`\n\n Generiert Testfälle für Eingabevorlagen, um sicherzustellen, dass sie die erwarteten Ergebnisse liefern. Dieses Tool:\n\n 1. Bietet Testfälle für Eingabeaufforderungsvorlagen:\n * Erstellt verschiedene Testszenarien basierend auf Ihrer Eingabeaufforderungsvorlage und Ihrem Kontextschema\n * Beispiel: „Tests für meine Vorlage für Gutenachtgeschichten erstellen“\n\n Das Tool bietet:\n\n * Eine Reihe empfohlener Testfälle\n * Verschiedene Parameterkombinationen zum Testen der Vorlagenrobustheit\n\n Dies hilft Ihnen:\n\n * Überprüfen der Funktionalität der Eingabeaufforderungsvorlage\n * Gewährleisten Sie konsistente KI-Reaktionen über alle Eingaben hinweg\n * Identifizieren Sie Randfälle und potenzielle Probleme\n * Verbessern Sie die Gesamtqualität Ihrer KI-Anwendungen\n\n* `list_followed_projects`\n\n Listet alle Projekte auf, denen der Benutzer auf CircleCI folgt. Dieses Tool:\n\n 1. Ruft Projekte ab und zeigt sie an:\n * Zeigt alle Projekte an, auf die der Benutzer Zugriff hat und die er verfolgt\n * Gibt den Projektnamen und den Projekt-Slug für jeden Eintrag an\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n\n Das Tool gibt eine formatierte Liste von Projekten zurück, Beispielausgabe:\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n Dies ist besonders nützlich für:\n\n * Identifizieren, welche CircleCI-Projekte für Sie verfügbar sind\n * Abrufen des für andere CircleCI-Tools benötigten Projekt-Slugs\n * Auswählen eines Projekts für nachfolgende Vorgänge\n\n Hinweis: Der ProjectSlug (nicht der Projektname) wird für viele andere CircleCI-Tools benötigt und wird für diese Tool-Aufrufe verwendet, nachdem ein Projekt ausgewählt wurde.\n\n* `run_pipeline`\n\n Löst die Ausführung einer Pipeline aus. Dieses Tool kann auf drei Arten verwendet werden:\n\n 1. Verwenden von Projekt-Slug und Branch (empfohlener Arbeitsablauf):\n\n * Listen Sie zunächst Ihre verfügbaren Projekte auf:\n * Verwenden Sie das Tool list\\_followed\\_projects, um Ihre Projekte zu erhalten\n * Beispiel: „Liste meine CircleCI-Projekte auf“\n * Wählen Sie dann das Projekt aus, dem ein ProjektSlug zugeordnet ist\n * Beispiel: „Lasst uns mein Projekt verwenden“\n * Fordern Sie dann an, die Pipeline für einen bestimmten Zweig auszuführen:\n * Beispiel: „Führen Sie die Pipeline für mein Projekt im Hauptzweig aus.“\n\n 2. Verwenden der CircleCI-URL:\n\n * Geben Sie eine CircleCI-URL in einem dieser Formate an:\n * Job-URL: \" \"\n * Workflow-URL: \" \"\n * Pipeline-URL: \" \"\n * Projekt-URL mit Zweig: \" \"\n * Beispiel: „Führen Sie die Pipeline für aus.“\n\n 3. Lokalen Projektkontext verwenden:\n\n * Funktioniert von Ihrem lokalen Arbeitsbereich aus, indem Folgendes bereitgestellt wird:\n * Stammpfad des Arbeitsbereichs\n * Git-Remote-URL\n * Filialname\n * Beispiel: „Führen Sie die Pipeline für mein aktuelles Projekt im Hauptzweig aus.“\n\n Das Tool gibt einen Link zur Überwachung der Pipeline-Ausführung zurück.\n\n Dies ist besonders nützlich für:\n\n * Schnelles Ausführen von Pipelines ohne Besuch der CircleCI-Web-Benutzeroberfläche\n * Ausführen von Pipelines aus einem bestimmten Zweig\n\n# Entwicklung\n\n## Erste Schritte\n\n1. Klonen Sie das Repository:\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. Installieren Sie Abhängigkeiten:\n\n ```bash\n pnpm install\n ```\n\n3. Erstellen Sie das Projekt:\n\n ```bash\n pnpm build\n ```\n\n## Docker-Container erstellen\n\nSie können den Docker-Container lokal erstellen mit:\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\nDadurch wird ein Docker-Image mit dem Tag `circleci:mcp-server-circleci` erstellt, das Sie mit jedem MCP-Client verwenden können.\n\nSo führen Sie den Container aus:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## Entwicklung mit MCP Inspector\n\nDie einfachste Möglichkeit, auf dem MCP-Server zu iterieren, ist die Verwendung des MCP-Inspektors. Weitere Informationen zum MCP-Inspektor finden Sie unter \n\n1. Starten Sie den Entwicklungsserver:\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. Starten Sie den Inspector in einem separaten Terminal:\n\n ```bash\n pnpm inspector\n ```\n\n3. Konfigurieren Sie die Umgebung:\n\n * Fügen Sie Ihren `CIRCLECI_TOKEN` zum Abschnitt „Umgebungsvariablen“ in der Inspektor-Benutzeroberfläche hinzu\n * Das Token benötigt Lesezugriff auf Ihre CircleCI-Projekte\n * Optional können Sie Ihre CircleCI-Basis-URL festlegen. Standardmäßig ist `https//circleci.com`\n\n## Testen\n\n* Führen Sie die Testsuite aus:\n\n ```bash\n pnpm test\n ```\n\n* Führen Sie während der Entwicklung Tests im Überwachungsmodus aus:\n\n ```bash\n pnpm test:watch\n ```\n\nAusführlichere Richtlinien für Beiträge finden Sie unter [CONTRIBUTING.md](CONTRIBUTING.md)","German","tag","de-DE",{"_29":41,"_33":44,"_38":45},{"_31":42,"_33":34,"_35":43},"This MCP server lets you use Cursor IDE, or any MCP Client enabled agent, to use natural language to accomplish things with CircleCI, e.g: Find the latest failed pipeline on my branch and get logs","# CircleCI MCP Server\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE)\n[![CircleCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main)\n[![npm](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\nModel Context Protocol (MCP) is a [new, standardized protocol](https://modelcontextprotocol.io/introduction) for managing context between large language models (LLMs) and external systems. In this repository, we provide an MCP Server for [CircleCI](https://circleci.com).\n\nThis lets you use Cursor IDE, Windsurf, Copilot, or any MCP supported Client, to use natural language to accomplish things with CircleCI, e.g.:\n\n- `Find the latest failed pipeline on my branch and get logs`\n https://github.com/CircleCI-Public/mcp-server-circleci/wiki#circleci-mcp-server-with-cursor-ide\n\nhttps://github.com/user-attachments/assets/3c765985-8827-442a-a8dc-5069e01edb74\n\n## Requirements\n\n- CircleCI API token - you can generate one through the CircleCI. [Learn more](https://circleci.com/docs/managing-api-tokens/) or [click here](https://app.circleci.com/settings/user/tokens) for quick access.\n\nFor NPX installation:\n- pnpm package manager - [Learn more](https://pnpm.io/installation)\n- Node.js >= v18.0.0\n\nFor Docker installation:\n- Docker - [Learn more](https://docs.docker.com/get-docker/)\n\n## Installation\n\n### Cursor\n\n#### Using NPX\n\nAdd the following to your cursor MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Using Docker\n\nAdd the following to your cursor MCP config:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### VS Code\n\n#### Using NPX\n\nTo install CircleCI MCP Server for VS Code in `.vscode/mcp.json`:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Using Docker\n\nTo install CircleCI MCP Server for VS Code in `.vscode/mcp.json` using Docker:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### Claude Desktop\n\n#### Using NPX\n\nAdd the following to your claude_desktop_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Using Docker\n\nAdd the following to your claude_desktop_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nTo find/create this file, first open your claude desktop settings. Then click on \"Developer\" in the left-hand bar of the Settings pane, and then click on \"Edit Config\"\n\nThis will create a configuration file at:\n\n- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n- Windows: %APPDATA%\\Claude\\claude_desktop_config.json\n\nSee the guide below for more information on using MCP servers with Claude Desktop:\nhttps://modelcontextprotocol.io/quickstart/user\n\n### Claude Code\n\n#### Using NPX\n\nAfter installing Claude Code, run the following command:\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Using Docker\n\nAfter installing Claude Code, run the following command:\n\n```bash\nclaude 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\n```\n\nSee the guide below for more information on using MCP servers with Claude Code:\nhttps://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp\n\n### Windsurf\n\n#### Using NPX\n\nAdd the following to your windsurf mcp_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Using Docker\n\nAdd the following to your windsurf mcp_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nSee the guide below for more information on using MCP servers with windsurf:\nhttps://docs.windsurf.com/windsurf/mcp\n\n### Installing via Smithery\n\nTo install CircleCI MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci):\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# Features\n\n## Supported Tools\n\n- `get_build_failure_logs`\n\n Retrieves detailed failure logs from CircleCI builds. This tool can be used in three ways:\n\n 1. Using Project Slug and Branch (Recommended Workflow):\n - First, list your available projects:\n - Use the list_followed_projects tool to get your projects\n - Example: \"List my CircleCI projects\"\n - Then choose the project, which has a projectSlug associated with it\n - Example: \"Lets use my-project\"\n - Then ask to retrieve the build failure logs for a specific branch:\n - Example: \"Get build failures for my-project on the main branch\"\n\n 2. Using CircleCI URLs:\n - Provide a failed job URL or pipeline URL directly\n - Example: \"Get logs from https://app.circleci.com/pipelines/github/org/repo/123\"\n\n 3. Using Local Project Context:\n - Works from your local workspace by providing:\n - Workspace root path\n - Git remote URL\n - Branch name\n - Example: \"Find the latest failed pipeline on my current branch\"\n\n The tool returns formatted logs including:\n\n - Job names\n - Step-by-step execution details\n - Failure messages and context\n\n This is particularly useful for:\n\n - Debugging failed builds\n - Analyzing test failures\n - Investigating deployment issues\n - Quick access to build logs without leaving your IDE\n\n- `find_flaky_tests`\n\n Identifies flaky tests in your CircleCI project by analyzing test execution history. This leverages the flaky test detection feature described here: https://circleci.com/blog/introducing-test-insights-with-flaky-test-detection/#flaky-test-detection\n\n This tool can be used in three ways:\n\n 1. Using Project Slug (Recommended Workflow):\n - First, list your available projects:\n - Use the list_followed_projects tool to get your projects\n - Example: \"List my CircleCI projects\"\n - Then choose the project, which has a projectSlug associated with it\n - Example: \"Lets use my-project\"\n - Then ask to retrieve the flaky tests:\n - Example: \"Get flaky tests for my-project\"\n\n 2. Using CircleCI Project URL:\n\n - Provide the project URL directly from CircleCI\n - Example: \"Find flaky tests in https://app.circleci.com/pipelines/github/org/repo\"\n\n 3. Using Local Project Context:\n - Works from your local workspace by providing:\n - Workspace root path\n - Git remote URL\n - Example: \"Find flaky tests in my current project\"\n\n The tool returns detailed information about flaky tests, including:\n\n - Test names and file locations\n - Failure messages and contexts\n\n This helps you:\n\n - Identify unreliable tests in your test suite\n - Get detailed context about test failures\n - Make data-driven decisions about test improvements\n\n- `get_latest_pipeline_status`\n\n Retrieves the status of the latest pipeline for a given branch. This tool can be used in three ways:\n\n 1. Using Project Slug and Branch (Recommended Workflow):\n - First, list your available projects:\n - Use the list_followed_projects tool to get your projects\n - Example: \"List my CircleCI projects\"\n - Then choose the project, which has a projectSlug associated with it\n - Example: \"Lets use my-project\"\n - Then ask to retrieve the latest pipeline status for a specific branch:\n - Example: \"Get the status of the latest pipeline for my-project on the main branch\"\n\n 2. Using CircleCI Project URL:\n\n - Provide the project URL directly from CircleCI\n - Example: \"Get the status of the latest pipeline for https://app.circleci.com/pipelines/github/org/repo\"\n\n 3. Using Local Project Context:\n - Works from your local workspace by providing:\n - Workspace root path\n - Git remote URL\n - Branch name\n - Example: \"Get the status of the latest pipeline for my current project\"\n\n The tool returns a formatted status of the latest pipeline:\n\n - Workflow names and their current status\n - Duration of each workflow\n - Creation and completion timestamps\n - Overall pipeline health\n\n Example output:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n This is particularly useful for:\n\n - Checking the status of the latest pipeline\n - Getting the status of the latest pipeline for a specific branch\n - Quickly checking the status of the latest pipeline without leaving your IDE\n\n- `get_job_test_results`\n\n Retrieves test metadata for CircleCI jobs, allowing you to analyze test results without leaving your IDE. This tool can be used in three ways:\n\n 1. Using Project Slug and Branch (Recommended Workflow):\n - First, list your available projects:\n - Use the list_followed_projects tool to get your projects\n - Example: \"List my CircleCI projects\"\n - Then choose the project, which has a projectSlug associated with it\n - Example: \"Lets use my-project\"\n - Then ask to retrieve the test results for a specific branch:\n - Example: \"Get test results for my-project on the main branch\"\n\n 2. Using CircleCI URL:\n\n - Provide a CircleCI URL in any of these formats:\n - Job URL: \"https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789\"\n - Workflow URL: \"https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def\"\n - Pipeline URL: \"https://app.circleci.com/pipelines/github/org/repo/123\"\n - Example: \"Get test results for https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def\"\n\n 3. Using Local Project Context:\n - Works from your local workspace by providing:\n - Workspace root path\n - Git remote URL\n - Branch name\n - Example: \"Get test results for my current project on the main branch\"\n\n The tool returns detailed test result information:\n\n - Summary of all tests (total, successful, failed)\n - Detailed information about failed tests including:\n - Test name and class\n - File location\n - Error messages\n - Runtime duration\n - List of successful tests with timing information\n - Filter by tests result\n\n This is particularly useful for:\n\n - Quickly analyzing test failures without visiting the CircleCI web UI\n - Identifying patterns in test failures\n - Finding slow tests that might need optimization\n - Checking test coverage across your project\n - Troubleshooting flaky tests\n\n Note: The tool requires that test metadata is properly configured in your CircleCI config. For more information on setting up test metadata collection, see:\n https://circleci.com/docs/collect-test-data/\n\n- `config_helper`\n\n Assists with CircleCI configuration tasks by providing guidance and validation. This tool helps you:\n\n 1. Validate CircleCI Config:\n - Checks your .circleci/config.yml for syntax and semantic errors\n - Example: \"Validate my CircleCI config\"\n\n The tool provides:\n\n - Detailed validation results\n - Configuration recommendations\n\n This helps you:\n\n - Catch configuration errors before pushing\n - Learn CircleCI configuration best practices\n - Troubleshoot configuration issues\n - Implement CircleCI features correctly\n\n- `create_prompt_template`\n\n Helps generate structured prompt templates for AI-enabled applications based on feature requirements. This tool:\n\n 1. Converts Feature Requirements to Structured Prompts:\n - Transforms user requirements into optimized prompt templates\n - Example: \"Create a prompt template for generating bedtime stories by age and topic\"\n\n The tool provides:\n\n - A structured prompt template\n - A context schema defining required input parameters\n\n This helps you:\n\n - Create effective prompts for AI applications\n - Standardize input parameters for consistent results\n - Build robust AI-powered features\n\n- `recommend_prompt_template_tests`\n\n Generates test cases for prompt templates to ensure they produce expected results. This tool:\n\n 1. Provides Test Cases for Prompt Templates:\n - Creates diverse test scenarios based on your prompt template and context schema\n - Example: \"Generate tests for my bedtime story prompt template\"\n\n The tool provides:\n\n - An array of recommended test cases\n - Various parameter combinations to test template robustness\n\n This helps you:\n\n - Validate prompt template functionality\n - Ensure consistent AI responses across inputs\n - Identify edge cases and potential issues\n - Improve overall AI application quality\n\n- `list_followed_projects`\n\n Lists all projects that the user is following on CircleCI. This tool:\n\n 1. Retrieves and Displays Projects:\n - Shows all projects the user has access to and is following\n - Provides the project name and projectSlug for each entry\n - Example: \"List my CircleCI projects\"\n\n The tool returns a formatted list of projects, example output:\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n This is particularly useful for:\n\n - Identifying which CircleCI projects are available to you\n - Obtaining the projectSlug needed for other CircleCI tools\n - Selecting a project for subsequent operations\n\n Note: The projectSlug (not the project name) is required for many other CircleCI tools, and will be used for those tool calls after a project is selected.\n\n- `run_pipeline`\n\n Triggers a pipeline to run. This tool can be used in three ways:\n\n 1. Using Project Slug and Branch (Recommended Workflow):\n - First, list your available projects:\n - Use the list_followed_projects tool to get your projects\n - Example: \"List my CircleCI projects\"\n - Then choose the project, which has a projectSlug associated with it\n - Example: \"Lets use my-project\"\n - Then ask to run the pipeline for a specific branch:\n - Example: \"Run the pipeline for my-project on the main branch\"\n\n 2. Using CircleCI URL:\n\n - Provide a CircleCI URL in any of these formats:\n - Job URL: \"https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def/jobs/789\"\n - Workflow URL: \"https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def\"\n - Pipeline URL: \"https://app.circleci.com/pipelines/github/org/repo/123\"\n - Project URL with branch: \"https://app.circleci.com/projects/github/org/repo?branch=main\"\n - Example: \"Run the pipeline for https://app.circleci.com/pipelines/github/org/repo/123/workflows/abc-def\"\n\n 3. Using Local Project Context:\n - Works from your local workspace by providing:\n - Workspace root path\n - Git remote URL\n - Branch name\n - Example: \"Run the pipeline for my current project on the main branch\"\n\n The tool returns a link to monitor the pipeline execution.\n\n This is particularly useful for:\n\n - Quickly running pipelines without visiting the CircleCI web UI\n - Running pipelines from a specific branch\n\n- `rerun_workflow`\n\n Reruns a workflow from its start or from the failed job.\n\n The tool returns the ID of the newly-created workflow, and a link to monitor the new workflow.\n\n This is particularly useful for:\n\n - Quickly rerunning a workflow from its start or from the failed job without visiting the CircleCI web UI\n\n# Development\n\n## Getting Started\n\n1. Clone the repository:\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. Install dependencies:\n\n ```bash\n pnpm install\n ```\n\n3. Build the project:\n ```bash\n pnpm build\n ```\n\n## Building Docker Container\n\nYou can build the Docker container locally using:\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\nThis will create a Docker image tagged as `circleci:mcp-server-circleci` that you can use with any MCP client.\n\nTo run the container:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## Development with MCP Inspector\n\nThe easiest way to iterate on the MCP Server is using the MCP inspector. You can learn more about the MCP inspector at https://modelcontextprotocol.io/docs/tools/inspector\n\n1. Start the development server:\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. In a separate terminal, launch the inspector:\n\n ```bash\n pnpm inspector\n ```\n\n3. Configure the environment:\n - Add your `CIRCLECI_TOKEN` to the Environment Variables section in the inspector UI\n - The token needs read access to your CircleCI projects\n - Optionally you can set your CircleCI Base URL. Defaults to `https//circleci.com`\n\n## Testing\n\n- Run the test suite:\n\n ```bash\n pnpm test\n ```\n\n- Run tests in watch mode during development:\n ```bash\n pnpm test:watch\n ```\n\nFor more detailed contribution guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md)\n","English","en-US",{"_29":47,"_33":50,"_38":51},{"_31":48,"_33":34,"_35":49},"Este servidor MCP le permite usar Cursor IDE, o cualquier agente habilitado para el cliente MCP, para usar lenguaje natural para lograr cosas con CircleCI, por ejemplo: Encontrar la última tubería fallida en mi rama y obtener registros","# Servidor MCP de CircleCI\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![npm](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\nEl Protocolo de Contexto de Modelo (MCP) es un [nuevo protocolo estandarizado](https://modelcontextprotocol.io/introduction) para gestionar el contexto entre grandes modelos de lenguaje (LLM) y sistemas externos. En este repositorio, ofrecemos un servidor MCP para [CircleCI](https://circleci.com) .\n\nEsto le permite usar Cursor IDE, Windsurf, Copilot o cualquier cliente compatible con MCP para usar lenguaje natural y lograr cosas con CircleCI, por ejemplo:\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## Requisitos\n\n* Token de la API de CircleCI: puedes generar uno a través de CircleCI. [Obtén más información](https://circleci.com/docs/managing-api-tokens/) o [haz clic aquí](https://app.circleci.com/settings/user/tokens) para acceder rápidamente.\n\nPara la instalación de NPX:\n\n* Gestor de paquetes pnpm: [Más información](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\nPara la instalación de Docker:\n\n* Docker - [Más información](https://docs.docker.com/get-docker/)\n\n## Instalación\n\n### Cursor\n\n#### Uso de NPX\n\nAgregue lo siguiente a la configuración MCP de su cursor:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Usando Docker\n\nAgregue lo siguiente a la configuración MCP de su cursor:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### Código VS\n\n#### Uso de NPX\n\nPara instalar CircleCI MCP Server para VS Code en `.vscode/mcp.json` :\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Usando Docker\n\nPara instalar CircleCI MCP Server para VS Code en `.vscode/mcp.json` usando Docker:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### Escritorio de Claude\n\n#### Uso de NPX\n\nAgregue lo siguiente a su claude\\_desktop\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Usando Docker\n\nAgregue lo siguiente a su claude\\_desktop\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nPara encontrar/crear este archivo, primero abra la configuración de escritorio de Claude. Luego, haga clic en \"Desarrollador\" en la barra izquierda del panel de Configuración y, a continuación, en \"Editar configuración\".\n\nEsto creará un archivo de configuración en:\n\n* macOS: ~/Biblioteca/Soporte de aplicaciones/Claude/claude\\_desktop\\_config.json\n* Ventanas: %APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\nConsulte la guía a continuación para obtener más información sobre el uso de servidores MCP con Claude Desktop: \n\n### Claude Code\n\n#### Uso de NPX\n\nDespués de instalar Claude Code, ejecute el siguiente comando:\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Usando Docker\n\nDespués de instalar Claude Code, ejecute el siguiente comando:\n\n```bash\nclaude 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\n```\n\nConsulte la guía a continuación para obtener más información sobre el uso de servidores MCP con Claude Code: \n\n### Windsurf\n\n#### Uso de NPX\n\nAgregue lo siguiente a su windsurf mcp\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Usando Docker\n\nAgregue lo siguiente a su windsurf mcp\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nConsulte la guía a continuación para obtener más información sobre el uso de servidores MCP con Windsurf: \n\n### Instalación mediante herrería\n\nPara instalar CircleCI MCP Server para Claude Desktop automáticamente a través de [Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci) :\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# Características\n\n## Herramientas compatibles\n\n* `get_build_failure_logs`\n\n Recupera registros detallados de errores de las compilaciones de CircleCI. Esta herramienta se puede utilizar de tres maneras:\n\n 1. Uso de Project Slug y Branch (flujo de trabajo recomendado):\n\n * Primero, enumera tus proyectos disponibles:\n * Utilice la herramienta list\\_followed\\_projects para obtener sus proyectos\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n * A continuación, seleccione el proyecto que tenga un projectSlug asociado.\n * Ejemplo: \"Usemos mi-proyecto\"\n * Luego, solicita recuperar los registros de errores de compilación para una rama específica:\n * Ejemplo: \"Obtener errores de compilación para mi proyecto en la rama principal\"\n\n 2. Uso de las URL de CircleCI:\n\n * Proporcione una URL de trabajo fallido o una URL de canalización directamente\n * Ejemplo: \"Obtener registros de \"\n\n 3. Uso del contexto del proyecto local:\n\n * Trabaja desde su espacio de trabajo local proporcionando:\n * Ruta raíz del espacio de trabajo\n * URL remota de Git\n * Nombre de la sucursal\n * Ejemplo: \"Buscar el último pipeline fallido en mi rama actual\"\n\n La herramienta devuelve registros formateados que incluyen:\n\n * Nombres de trabajos\n * Detalles de ejecución paso a paso\n * Mensajes de error y contexto\n\n Esto es particularmente útil para:\n\n * Depuración de compilaciones fallidas\n * Análisis de fallos de pruebas\n * Investigación de problemas de implementación\n * Acceso rápido a los registros de compilación sin salir de su IDE\n\n* `find_flaky_tests`\n\n Identifica pruebas inestables en tu proyecto CircleCI analizando el historial de ejecución de pruebas. Esto aprovecha la función de detección de pruebas inestables que se describe aquí: \n\n Esta herramienta se puede utilizar de tres maneras:\n\n 1. Uso de Project Slug (flujo de trabajo recomendado):\n\n * Primero, enumera tus proyectos disponibles:\n * Utilice la herramienta list\\_followed\\_projects para obtener sus proyectos\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n * A continuación, seleccione el proyecto que tenga un projectSlug asociado.\n * Ejemplo: \"Usemos mi-proyecto\"\n * Luego pide recuperar las pruebas fallidas:\n * Ejemplo: \"Obtener pruebas inestables para mi proyecto\"\n\n 2. Usando la URL del proyecto CircleCI:\n\n * Proporcione la URL del proyecto directamente desde CircleCI\n * Ejemplo: \"Encuentra pruebas inestables en \"\n\n 3. Uso del contexto del proyecto local:\n\n * Trabaja desde su espacio de trabajo local proporcionando:\n * Ruta raíz del espacio de trabajo\n * URL remota de Git\n * Ejemplo: \"Encontrar pruebas defectuosas en mi proyecto actual\"\n\n La herramienta devuelve información detallada sobre pruebas inestables, que incluye:\n\n * Nombres de prueba y ubicaciones de archivos\n * Mensajes y contextos de fallo\n\n Esto le ayudará a:\n\n * Identifique pruebas no confiables en su conjunto de pruebas\n * Obtenga un contexto detallado sobre los fallos de las pruebas\n * Tome decisiones basadas en datos sobre mejoras en las pruebas\n\n* `get_latest_pipeline_status`\n\n Recupera el estado del último pipeline de una rama determinada. Esta herramienta se puede utilizar de tres maneras:\n\n 1. Uso de Project Slug y Branch (flujo de trabajo recomendado):\n\n * Primero, enumera tus proyectos disponibles:\n * Utilice la herramienta list\\_followed\\_projects para obtener sus proyectos\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n * A continuación, seleccione el proyecto que tenga un projectSlug asociado.\n * Ejemplo: \"Usemos mi-proyecto\"\n * A continuación, solicita recuperar el último estado del pipeline para una rama específica:\n * Ejemplo: \"Obtener el estado del último pipeline de mi proyecto en la rama principal\"\n\n 2. Usando la URL del proyecto CircleCI:\n\n * Proporcione la URL del proyecto directamente desde CircleCI\n * Ejemplo: \"Obtener el estado del último pipeline para \"\n\n 3. Uso del contexto del proyecto local:\n\n * Trabaja desde su espacio de trabajo local proporcionando:\n * Ruta raíz del espacio de trabajo\n * URL remota de Git\n * Nombre de la sucursal\n * Ejemplo: \"Obtener el estado del último pipeline de mi proyecto actual\"\n\n La herramienta devuelve un estado formateado del último pipeline:\n\n * Nombres de flujos de trabajo y su estado actual\n * Duración de cada flujo de trabajo\n * Marcas de tiempo de creación y finalización\n * Estado general del oleoducto\n\n Ejemplo de salida:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n Esto es particularmente útil para:\n\n * Comprobación del estado del último pipeline\n * Obtener el estado del último pipeline para una sucursal específica\n * Comprobación rápida del estado del último pipeline sin salir del IDE\n\n* `get_job_test_results`\n\n Recupera metadatos de pruebas para trabajos de CircleCI, lo que permite analizar los resultados sin salir del IDE. Esta herramienta se puede usar de tres maneras:\n\n 1. Uso de Project Slug y Branch (flujo de trabajo recomendado):\n\n * Primero, enumera tus proyectos disponibles:\n * Utilice la herramienta list\\_followed\\_projects para obtener sus proyectos\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n * A continuación, seleccione el proyecto que tenga un projectSlug asociado.\n * Ejemplo: \"Usemos mi-proyecto\"\n * Luego solicita recuperar los resultados de la prueba para una rama específica:\n * Ejemplo: \"Obtener resultados de pruebas para mi-proyecto en la rama principal\"\n\n 2. Usando la URL de CircleCI:\n\n * Proporcione una URL de CircleCI en cualquiera de estos formatos:\n * URL del trabajo: \" \"\n * URL del flujo de trabajo: \" \"\n * URL de la canalización: \" \"\n * Ejemplo: \"Obtener resultados de la prueba para \"\n\n 3. Uso del contexto del proyecto local:\n\n * Trabaja desde su espacio de trabajo local proporcionando:\n * Ruta raíz del espacio de trabajo\n * URL remota de Git\n * Nombre de la sucursal\n * Ejemplo: \"Obtener resultados de pruebas para mi proyecto actual en la rama principal\"\n\n La herramienta devuelve información detallada de los resultados de la prueba:\n\n * Resumen de todas las pruebas (total, exitosas, fallidas)\n * Información detallada sobre las pruebas fallidas, incluyendo:\n * Nombre y clase de la prueba\n * Ubicación del archivo\n * Mensajes de error\n * Duración del tiempo de ejecución\n * Lista de pruebas exitosas con información de tiempo\n * Filtrar por resultado de pruebas\n\n Esto es particularmente útil para:\n\n * Análisis rápido de fallas de pruebas sin visitar la interfaz web de CircleCI\n * Identificación de patrones en fallos de pruebas\n * Encontrar pruebas lentas que podrían necesitar optimización\n * Comprobación de la cobertura de pruebas en todo el proyecto\n * Solución de problemas de pruebas inestables\n\n Nota: La herramienta requiere que los metadatos de prueba estén configurados correctamente en la configuración de CircleCI. Para obtener más información sobre cómo configurar la recopilación de metadatos de prueba, consulte: \n\n* `config_helper`\n\n Asiste en las tareas de configuración de CircleCI proporcionando orientación y validación. Esta herramienta le ayuda a:\n\n 1. Validar la configuración de CircleCI:\n * Comprueba su .circleci/config.yml en busca de errores de sintaxis y semántica\n * Ejemplo: \"Validar mi configuración de CircleCI\"\n\n La herramienta proporciona:\n\n * Resultados detallados de la validación\n * Recomendaciones de configuración\n\n Esto le ayudará a:\n\n * Detectar errores de configuración antes de enviar\n * Aprenda las mejores prácticas de configuración de CircleCI\n * Solucionar problemas de configuración\n * Implementar correctamente las funciones de CircleCI\n\n* `create_prompt_template`\n\n Ayuda a generar plantillas de indicaciones estructuradas para aplicaciones con IA según los requisitos de las funciones. Esta herramienta:\n\n 1. Convierte los requisitos de las funciones en indicaciones estructuradas:\n * Transforma los requisitos del usuario en plantillas de indicaciones optimizadas\n * Ejemplo: \"Crear una plantilla de indicaciones para generar cuentos para dormir por edad y tema\"\n\n La herramienta proporciona:\n\n * Una plantilla de mensaje estructurado\n * Un esquema de contexto que define los parámetros de entrada requeridos\n\n Esto le ayudará a:\n\n * Cree indicaciones efectivas para aplicaciones de IA\n * Estandarizar los parámetros de entrada para obtener resultados consistentes\n * Cree funciones robustas impulsadas por IA\n\n* `recommend_prompt_template_tests`\n\n Genera casos de prueba para plantillas de indicaciones para garantizar que produzcan los resultados esperados. Esta herramienta:\n\n 1. Proporciona casos de prueba para plantillas de indicaciones:\n * Crea diversos escenarios de prueba basados en su plantilla de solicitud y esquema de contexto\n * Ejemplo: \"Generar pruebas para mi plantilla de indicaciones para el cuento antes de dormir\"\n\n La herramienta proporciona:\n\n * Una serie de casos de prueba recomendados\n * Varias combinaciones de parámetros para probar la robustez de la plantilla\n\n Esto le ayudará a:\n\n * Validar la funcionalidad de la plantilla de solicitud\n * Asegúrese de que las respuestas de IA sean consistentes en todas las entradas\n * Identificar casos extremos y problemas potenciales\n * Mejorar la calidad general de las aplicaciones de IA\n\n* `list_followed_projects`\n\n Enumera todos los proyectos que el usuario sigue en CircleCI. Esta herramienta:\n\n 1. Recupera y muestra proyectos:\n * Muestra todos los proyectos a los que el usuario tiene acceso y está siguiendo\n * Proporciona el nombre del proyecto y el projectSlug para cada entrada\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n\n La herramienta devuelve una lista formateada de proyectos, ejemplo de salida:\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n Esto es particularmente útil para:\n\n * Identificar qué proyectos de CircleCI están disponibles para usted\n * Obtener el projectSlug necesario para otras herramientas de CircleCI\n * Seleccionar un proyecto para operaciones posteriores\n\n Nota: El projectSlug (no el nombre del proyecto) es necesario para muchas otras herramientas de CircleCI y se utilizará para aquellas llamadas de herramientas después de seleccionar un proyecto.\n\n* `run_pipeline`\n\n Activa la ejecución de una canalización. Esta herramienta se puede usar de tres maneras:\n\n 1. Uso de Project Slug y Branch (flujo de trabajo recomendado):\n\n * Primero, enumera tus proyectos disponibles:\n * Utilice la herramienta list\\_followed\\_projects para obtener sus proyectos\n * Ejemplo: \"Enumerar mis proyectos de CircleCI\"\n * A continuación, seleccione el proyecto que tenga un projectSlug asociado.\n * Ejemplo: \"Usemos mi-proyecto\"\n * Luego solicita ejecutar el pipeline para una rama específica:\n * Ejemplo: \"Ejecutar la canalización para mi-proyecto en la rama principal\"\n\n 2. Usando la URL de CircleCI:\n\n * Proporcione una URL de CircleCI en cualquiera de estos formatos:\n * URL del trabajo: \" \"\n * URL del flujo de trabajo: \" \"\n * URL de la canalización: \" \"\n * URL del proyecto con rama: \" \"\n * Ejemplo: \"Ejecutar la canalización para \"\n\n 3. Uso del contexto del proyecto local:\n\n * Trabaja desde su espacio de trabajo local proporcionando:\n * Ruta raíz del espacio de trabajo\n * URL remota de Git\n * Nombre de la sucursal\n * Ejemplo: \"Ejecutar la canalización de mi proyecto actual en la rama principal\"\n\n La herramienta devuelve un enlace para monitorear la ejecución del pipeline.\n\n Esto es particularmente útil para:\n\n * Ejecución rápida de pipelines sin necesidad de visitar la interfaz web de CircleCI\n * Ejecución de tuberías desde una rama específica\n\n# Desarrollo\n\n## Empezando\n\n1. Clonar el repositorio:\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. Instalar dependencias:\n\n ```bash\n pnpm install\n ```\n\n3. Construir el proyecto:\n\n ```bash\n pnpm build\n ```\n\n## Construcción de un contenedor Docker\n\nPuedes construir el contenedor Docker localmente usando:\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\nEsto creará una imagen de Docker etiquetada como `circleci:mcp-server-circleci` que puedes usar con cualquier cliente MCP.\n\nPara ejecutar el contenedor:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## Desarrollo con MCP Inspector\n\nLa forma más sencilla de iterar en el servidor MCP es mediante el inspector MCP. Puede obtener más información sobre el inspector MCP en \n\n1. Inicie el servidor de desarrollo:\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. En una terminal separada, inicie el inspector:\n\n ```bash\n pnpm inspector\n ```\n\n3. Configurar el entorno:\n\n * Agregue su `CIRCLECI_TOKEN` a la sección Variables de entorno en la interfaz de usuario del inspector\n * El token necesita acceso de lectura a sus proyectos CircleCI\n * Opcionalmente, puede configurar la URL base de CircleCI. El valor predeterminado es `https//circleci.com`\n\n## Pruebas\n\n* Ejecute el conjunto de pruebas:\n\n ```bash\n pnpm test\n ```\n\n* Ejecutar pruebas en modo de observación durante el desarrollo:\n\n ```bash\n pnpm test:watch\n ```\n\nPara obtener pautas de contribución más detalladas, consulte [CONTRIBUTING.md](CONTRIBUTING.md)","Spanish","es-ES",{"_29":53,"_33":56,"_38":57},{"_31":54,"_33":34,"_35":55},"このMCPサーバーを使用すると、カーソルIDEまたはMCPクライアント対応エージェントを使用して、自然言語を使用してCircleCIでさまざまなことを行うことができます。たとえば、自分のブランチで最近失敗したパイプラインを見つけてログを取得するなどです。","# CircleCI MCP サーバー\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![サークルCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![npm](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\nモデルコンテキストプロトコル（MCP）は、大規模言語モデル（LLM）と外部システム間のコンテキストを管理するための[新しい標準化プロトコル](https://modelcontextprotocol.io/introduction)です。このリポジトリでは、 [CircleCI](https://circleci.com)用のMCPサーバーを提供します。\n\nこれにより、Cursor IDE、Windsurf、Copilot、または MCP でサポートされている任意のクライアントを使用して、自然言語で CircleCI で次の操作を実行できるようになります。\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## 要件\n\n* CircleCI APIトークン - CircleCIから生成できます。[詳細はこちらをご覧ください](https://circleci.com/docs/managing-api-tokens/)。または、[こちらをクリックして](https://app.circleci.com/settings/user/tokens)クイックアクセスしてください。\n\nNPX インストールの場合:\n\n* pnpm パッケージマネージャー -[詳細はこちら](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\nDocker インストールの場合:\n\n* Docker -[詳細はこちら](https://docs.docker.com/get-docker/)\n\n## インストール\n\n### カーソル\n\n#### NPXの使用\n\nカーソル MCP 構成に以下を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Dockerの使用\n\nカーソル MCP 構成に以下を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### VSコード\n\n#### NPXの使用\n\n`.vscode/mcp.json`に VS Code 用の CircleCI MCP Server をインストールするには:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Dockerの使用\n\nDocker を使用して`.vscode/mcp.json`に VS Code 用の CircleCI MCP Server をインストールするには:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### クロードデスクトップ\n\n#### NPXの使用\n\nclaude\\_desktop\\_config.json に次の内容を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Dockerの使用\n\nclaude\\_desktop\\_config.json に次の内容を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nこのファイルを見つける/作成するには、まずClaudeデスクトップの設定を開きます。次に、設定パネルの左側のバーにある「開発」をクリックし、「設定の編集」をクリックします。\n\nこれにより、次の場所に構成ファイルが作成されます。\n\n* macOS: ~/ライブラリ/アプリケーションサポート/Claude/claude\\_desktop\\_config.json\n* Windows: %APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\nClaude Desktop で MCP サーバーを使用する方法の詳細については、以下のガイドを参照してください: \n\n### クロード・コード\n\n#### NPXの使用\n\nClaude Code をインストールした後、次のコマンドを実行します。\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Dockerの使用\n\nClaude Code をインストールした後、次のコマンドを実行します。\n\n```bash\nclaude 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\n```\n\nClaude Code で MCP サーバーを使用する方法の詳細については、以下のガイドを参照してください: \n\n### ウィンドサーフィン\n\n#### NPXの使用\n\nwindsurf mcp\\_config.json に以下を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Dockerの使用\n\nwindsurf mcp\\_config.json に以下を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nWindsurf で MCP サーバーを使用する方法の詳細については、以下のガイドを参照してください: \n\n### Smithery経由でインストール\n\n[Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci)経由で Claude Desktop 用の CircleCI MCP Server を自動的にインストールするには:\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# 特徴\n\n## サポートされているツール\n\n* `get_build_failure_logs`\n\n CircleCI ビルドから詳細な失敗ログを取得します。このツールは次の 3 つの方法で使用できます。\n\n 1. プロジェクトスラッグとブランチの使用（推奨ワークフロー）:\n\n * まず、利用可能なプロジェクトをリストします。\n * list\\_followed\\_projectsツールを使用してプロジェクトを取得します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n * 次に、プロジェクトスラッグが関連付けられているプロジェクトを選択します。\n * 例:「my-project を使ってみましょう」\n * 次に、特定のブランチのビルド失敗ログを取得するように要求します。\n * 例:「メインブランチの my-project のビルド失敗を取得する」\n\n 2. CircleCI URL の使用:\n\n * 失敗したジョブのURLまたはパイプラインのURLを直接指定します\n * 例: 「からログを取得する」\n\n 3. ローカルプロジェクトコンテキストの使用:\n\n * 以下を提供することで、ローカルワークスペースから作業できます。\n * ワークスペースのルートパス\n * GitリモートURL\n * 支店名\n * 例: 「現在のブランチで最後に失敗したパイプラインを見つける」\n\n このツールは、次のようなフォーマットされたログを返します。\n\n * ジョブ名\n * ステップバイステップの実行の詳細\n * 失敗メッセージとコンテキスト\n\n これは特に次の場合に役立ちます:\n\n * 失敗したビルドのデバッグ\n * テストの失敗を分析する\n * 展開の問題の調査\n * IDEを離れずにビルドログに素早くアクセス\n\n* `find_flaky_tests`\n\n テスト実行履歴を分析し、CircleCIプロジェクト内の不安定なテストを特定します。この機能は、https: [//circleci.com/blog/introducing-test-insights-with-flaky-test-detection/#flaky-test-detection](https://circleci.com/blog/introducing-test-insights-with-flaky-test-detection/#flaky-test-detection)で説明されている不安定なテスト検出機能を活用します。\n\n このツールは次の 3 つの方法で使用できます。\n\n 1. プロジェクトスラッグの使用（推奨ワークフロー）:\n\n * まず、利用可能なプロジェクトをリストします。\n * list\\_followed\\_projectsツールを使用してプロジェクトを取得します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n * 次に、projectSlugが関連付けられているプロジェクトを選択します。\n * 例:「my-project を使ってみましょう」\n * 次に、不安定なテストを取得するように要求します。\n * 例: 「my-project の不安定なテストを取得する」\n\n 2. CircleCI プロジェクト URL の使用:\n\n * CircleCI からプロジェクト URL を直接提供します\n * 例: 「で不安定なテストを見つける」\n\n 3. ローカルプロジェクトコンテキストの使用:\n\n * 以下を提供することで、ローカルワークスペースから作業できます。\n * ワークスペースのルートパス\n * GitリモートURL\n * 例: 「現在のプロジェクトで不安定なテストを見つける」\n\n このツールは、次のような不安定なテストに関する詳細な情報を返します。\n\n * テスト名とファイルの場所\n * 失敗メッセージとコンテキスト\n\n これは次のことに役立ちます:\n\n * テストスイート内の信頼性の低いテストを特定する\n * テストの失敗に関する詳細なコンテキストを取得する\n * テストの改善についてデータに基づいた意思決定を行う\n\n* `get_latest_pipeline_status`\n\n 指定されたブランチの最新のパイプラインのステータスを取得します。このツールは3つの方法で使用できます。\n\n 1. プロジェクトスラッグとブランチの使用（推奨ワークフロー）:\n\n * まず、利用可能なプロジェクトをリストします。\n * list\\_followed\\_projectsツールを使用してプロジェクトを取得します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n * 次に、projectSlugが関連付けられているプロジェクトを選択します。\n * 例:「my-project を使ってみましょう」\n * 次に、特定のブランチの最新のパイプラインステータスを取得するように要求します。\n * 例:「メインブランチの my-project の最新パイプラインのステータスを取得する」\n\n 2. CircleCI プロジェクト URL の使用:\n\n * CircleCI からプロジェクト URL を直接提供します\n * 例: 「の最新パイプラインのステータスを取得する」\n\n 3. ローカルプロジェクトコンテキストの使用:\n\n * 以下を提供することで、ローカルワークスペースから作業できます。\n * ワークスペースのルートパス\n * GitリモートURL\n * 支店名\n * 例: 「現在のプロジェクトの最新のパイプラインのステータスを取得する」\n\n ツールは最新のパイプラインのフォーマットされたステータスを返します。\n\n * ワークフロー名と現在のステータス\n * 各ワークフローの所要時間\n * 作成と完了のタイムスタンプ\n * パイプライン全体の健全性\n\n 出力例:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n これは特に次の場合に役立ちます:\n\n * 最新のパイプラインのステータスを確認する\n * 特定のブランチの最新パイプラインのステータスを取得する\n * IDEを離れずに最新のパイプラインのステータスを素早く確認\n\n* `get_job_test_results`\n\n CircleCIジョブのテストメタデータを取得し、IDEを離れることなくテスト結果を分析できます。このツールは以下の3つの方法で使用できます。\n\n 1. プロジェクトスラッグとブランチの使用（推奨ワークフロー）:\n\n * まず、利用可能なプロジェクトをリストします。\n * list\\_followed\\_projectsツールを使用してプロジェクトを取得します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n * 次に、projectSlugが関連付けられているプロジェクトを選択します。\n * 例:「my-project を使ってみましょう」\n * 次に、特定のブランチのテスト結果を取得するように要求します。\n * 例:「メインブランチの my-project のテスト結果を取得する」\n\n 2. CircleCI URL の使用:\n\n * 次のいずれかの形式で CircleCI URL を指定します。\n * ジョブ URL: 「」\n * ワークフロー URL: 「」\n * パイプライン URL: 「」\n * 例: 「のテスト結果を取得する」\n\n 3. ローカルプロジェクトコンテキストの使用:\n\n * 以下を提供することで、ローカルワークスペースから作業できます。\n * ワークスペースのルートパス\n * GitリモートURL\n * 支店名\n * 例:「メインブランチ上の現在のプロジェクトのテスト結果を取得する」\n\n ツールは詳細なテスト結果情報を返します。\n\n * すべてのテストの概要（合計、成功、失敗）\n * 失敗したテストに関する詳細情報:\n * テスト名とクラス\n * ファイルの場所\n * エラーメッセージ\n * 実行時間\n * 成功したテストのリストとタイミング情報\n * テスト結果でフィルタリング\n\n これは特に次の場合に役立ちます:\n\n * CircleCI ウェブ UI にアクセスせずにテストの失敗を迅速に分析\n * テスト失敗のパターンの特定\n * 最適化が必要な可能性のある遅いテストを見つける\n * プロジェクト全体のテスト範囲を確認する\n * 不安定なテストのトラブルシューティング\n\n 注: このツールを使用するには、CircleCI の設定でテストメタデータが適切に設定されている必要があります。テストメタデータの収集設定の詳細については、 [https](https://circleci.com/docs/collect-test-data/) ://circleci.com/docs/collect-test-data/ をご覧ください。\n\n* `config_helper`\n\n CircleCI の設定タスクをガイダンスと検証で支援します。このツールは以下のことに役立ちます。\n\n 1. CircleCI 構成を検証します。\n * .circleci/config.yml の構文エラーとセマンティックエラーをチェックします\n * 例:「CircleCI の設定を検証する」\n\n このツールは以下を提供します:\n\n * 詳細な検証結果\n * 構成の推奨事項\n\n これは次のことに役立ちます:\n\n * プッシュする前に設定エラーをキャッチする\n * CircleCI の設定のベストプラクティスを学ぶ\n * 構成の問題のトラブルシューティング\n * CircleCIの機能を正しく実装する\n\n* `create_prompt_template`\n\n AI対応アプリケーションの機能要件に基づいて、構造化されたプロンプトテンプレートを生成するのに役立ちます。このツールは以下の機能を提供します。\n\n 1. 機能要件を構造化されたプロンプトに変換します。\n * ユーザーの要件を最適化されたプロンプトテンプレートに変換します\n * 例: 「年齢とトピック別に就寝時のお話を生成するためのプロンプトテンプレートを作成する」\n\n このツールは以下を提供します:\n\n * 構造化されたプロンプトテンプレート\n * 必要な入力パラメータを定義するコンテキストスキーマ\n\n これは次のことに役立ちます:\n\n * AIアプリケーションに効果的なプロンプトを作成する\n * 一貫した結果を得るために入力パラメータを標準化する\n * 堅牢なAI搭載機能を構築する\n\n* `recommend_prompt_template_tests`\n\n プロンプトテンプレートのテストケースを生成し、期待通りの結果が得られるかを確認します。このツールは以下の機能を備えています。\n\n 1. プロンプトテンプレートのテストケースを提供します。\n * プロンプトテンプレートとコンテキストスキーマに基づいて多様なテストシナリオを作成します\n * 例: 「就寝時のストーリープロンプトテンプレートのテストを生成する」\n\n このツールは以下を提供します:\n\n * 推奨されるテストケースの配列\n * テンプレートの堅牢性をテストするためのさまざまなパラメータの組み合わせ\n\n これは次のことに役立ちます:\n\n * プロンプトテンプレートの機能を検証する\n * 入力全体にわたって一貫したAI応答を確保する\n * エッジケースと潜在的な問題を特定する\n * AIアプリケーション全体の品質を向上\n\n* `list_followed_projects`\n\n CircleCIでユーザーがフォローしているすべてのプロジェクトを一覧表示します。このツールは以下の機能を提供します。\n\n 1. プロジェクトを取得して表示します:\n * ユーザーがアクセスでき、フォローしているすべてのプロジェクトを表示します\n * 各エントリにプロジェクト名とプロジェクトスラッグを提供します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n\n ツールはフォーマットされたプロジェクトのリストを返します。出力例:\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n これは特に次の場合に役立ちます:\n\n * 利用可能な CircleCI プロジェクトを特定する\n * 他の CircleCI ツールに必要な projectSlug を取得する\n * 後続の操作のためのプロジェクトの選択\n\n 注: projectSlug (プロジェクト名ではありません) は他の多くの CircleCI ツールに必須であり、プロジェクトを選択した後にそれらのツールの呼び出しに使用されます。\n\n* `run_pipeline`\n\n パイプラインの実行をトリガーします。このツールは次の3つの方法で使用できます。\n\n 1. プロジェクトスラッグとブランチの使用（推奨ワークフロー）:\n\n * まず、利用可能なプロジェクトをリストします。\n * list\\_followed\\_projectsツールを使用してプロジェクトを取得します\n * 例:「CircleCI プロジェクトの一覧を表示する」\n * 次に、projectSlugが関連付けられているプロジェクトを選択します。\n * 例:「my-project を使ってみましょう」\n * 次に、特定のブランチに対してパイプラインを実行するように要求します。\n * 例:「メインブランチで my-project のパイプラインを実行する」\n\n 2. CircleCI URL の使用:\n\n * 次のいずれかの形式で CircleCI URL を指定します。\n * ジョブ URL: 「」\n * ワークフロー URL: 「」\n * パイプライン URL: 「」\n * ブランチを含むプロジェクト URL: \" \"\n * 例: 「のパイプラインを実行します」\n\n 3. ローカルプロジェクトコンテキストの使用:\n\n * 以下を提供することで、ローカルワークスペースから作業できます。\n * ワークスペースのルートパス\n * GitリモートURL\n * 支店名\n * 例:「メインブランチで現在のプロジェクトのパイプラインを実行する」\n\n このツールは、パイプラインの実行を監視するためのリンクを返します。\n\n これは特に次の場合に役立ちます:\n\n * CircleCI の Web UI にアクセスせずにパイプラインをすばやく実行\n * 特定のブランチからパイプラインを実行する\n\n# 発達\n\n## はじめる\n\n1. リポジトリをクローンします。\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. 依存関係をインストールします:\n\n ```bash\n pnpm install\n ```\n\n3. プロジェクトをビルドします。\n\n ```bash\n pnpm build\n ```\n\n## Dockerコンテナの構築\n\n次のコマンドを使用して、Docker コンテナをローカルでビルドできます。\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\nこれにより、任意の MCP クライアントで使用できる`circleci:mcp-server-circleci`としてタグ付けされた Docker イメージが作成されます。\n\nコンテナを実行するには:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## MCP Inspectorを使用した開発\n\nMCPサーバーで反復処理を行う最も簡単な方法は、MCPインスペクターを使用することです。MCPインスペクターの詳細については、をご覧ください。\n\n1. 開発サーバーを起動します。\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. 別のターミナルで、インスペクターを起動します。\n\n ```bash\n pnpm inspector\n ```\n\n3. 環境を構成します。\n\n * インスペクターUIの環境変数セクションに`CIRCLECI_TOKEN`を追加します。\n * トークンにはCircleCIプロジェクトへの読み取りアクセス権が必要です\n * オプションでCircleCIのベースURLを設定できます。デフォルトは`https//circleci.com`です。\n\n## テスト\n\n* テストスイートを実行します。\n\n ```bash\n pnpm test\n ```\n\n* 開発中にウォッチモードでテストを実行します。\n\n ```bash\n pnpm test:watch\n ```\n\nより詳しい貢献ガイドラインについては、 [CONTRIBUTING.md](CONTRIBUTING.md)をご覧ください。","Japanese","ja-JP",{"_29":59,"_33":62,"_38":63},{"_31":60,"_33":34,"_35":61},"이 MCP 서버를 사용하면 Cursor IDE 또는 MCP 클라이언트가 활성화된 에이전트를 사용하여 자연어를 사용하여 CircleCI에서 작업을 수행할 수 있습니다. 예: 내 브랜치에서 실패한 최신 파이프라인을 찾고 로그를 가져옵니다.","# CircleCI MCP 서버\n\n[![깃허브](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![서클씨아이](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![엔피엠](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\n모델 컨텍스트 프로토콜(MCP)은 대규모 언어 모델(LLM)과 외부 시스템 간의 컨텍스트를 관리하기 위한 [새로운 표준화된 프로토콜](https://modelcontextprotocol.io/introduction) 입니다. 이 저장소에서는 [CircleCI](https://circleci.com) 용 MCP 서버를 제공합니다.\n\n이를 통해 Cursor IDE, Windsurf, Copilot 또는 MCP 지원 클라이언트를 사용하여 자연어를 사용하여 CircleCI로 작업을 수행할 수 있습니다.예:\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## 요구 사항\n\n* CircleCI API 토큰 - CircleCI를 통해 생성할 수 있습니다. [자세히 알아보거나](https://circleci.com/docs/managing-api-tokens/) [여기를 클릭하여](https://app.circleci.com/settings/user/tokens) 빠르게 액세스하세요.\n\nNPX 설치의 경우:\n\n* pnpm 패키지 관리자 - [자세히 알아보기](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\nDocker 설치의 경우:\n\n* Docker - [자세히 알아보기](https://docs.docker.com/get-docker/)\n\n## 설치\n\n### 커서\n\n#### NPX 사용하기\n\n커서 MCP 구성에 다음을 추가하세요.\n\n지엑스피1\n\n#### Docker 사용\n\n커서 MCP 구성에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### VS 코드\n\n#### NPX 사용하기\n\n`.vscode/mcp.json` 에 VS Code용 CircleCI MCP 서버를 설치하려면 다음을 수행합니다.\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Docker 사용\n\nDocker를 사용하여 `.vscode/mcp.json` 에 VS Code용 CircleCI MCP 서버를 설치하려면:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### 클로드 데스크탑\n\n#### NPX 사용하기\n\nclaude\\_desktop\\_config.json에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Docker 사용\n\nclaude\\_desktop\\_config.json에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n이 파일을 찾거나 생성하려면 먼저 Claude 데스크톱 설정을 엽니다. 그런 다음 설정 창 왼쪽 막대에서 \"개발자\"를 클릭하고 \"구성 편집\"을 클릭합니다.\n\n이렇게 하면 다음 위치에 구성 파일이 생성됩니다.\n\n* macOS: ~/Library/Application Support/Claude/claude\\_desktop\\_config.json\n* Windows: %APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\nClaude Desktop과 함께 MCP 서버를 사용하는 방법에 대한 자세한 내용은 아래 가이드를 참조하세요: \n\n### 클로드 코드\n\n#### NPX 사용하기\n\nClaude Code를 설치한 후 다음 명령을 실행하세요.\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Docker 사용\n\nClaude Code를 설치한 후 다음 명령을 실행하세요.\n\n```bash\nclaude 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\n```\n\nClaude Code와 함께 MCP 서버를 사용하는 방법에 대한 자세한 내용은 아래 가이드를 참조하세요. \n\n### 윈드서핑\n\n#### NPX 사용하기\n\nwindsurf mcp\\_config.json에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Docker 사용\n\nwindsurf mcp\\_config.json에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nWindsurf와 함께 MCP 서버를 사용하는 방법에 대한 자세한 내용은 아래 가이드를 참조하세요: \n\n### Smithery를 통해 설치\n\n[Smithery를](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci) 통해 Claude Desktop에 CircleCI MCP 서버를 자동으로 설치하려면:\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# 특징\n\n## 지원되는 도구\n\n* `get_build_failure_logs`\n\n CircleCI 빌드에서 자세한 실패 로그를 검색합니다. 이 도구는 세 가지 방법으로 사용할 수 있습니다.\n\n 1. Project Slug 및 Branch 사용(권장 워크플로):\n\n * 먼저, 사용 가능한 프로젝트를 나열하세요.\n * list\\_followed\\_projects 도구를 사용하여 프로젝트를 가져옵니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n * 그런 다음 프로젝트와 연관된 projectSlug가 있는 프로젝트를 선택하세요.\n * 예: \"내 프로젝트를 사용해 보자\"\n * 그런 다음 특정 브랜치에 대한 빌드 실패 로그를 검색하도록 요청합니다.\n * 예: \"메인 브랜치에서 my-project에 대한 빌드 실패를 가져옵니다\"\n\n 2. CircleCI URL 사용:\n\n * 실패한 작업 URL 또는 파이프라인 URL을 직접 제공하세요.\n * 예: \" 에서 로그 가져오기\"\n\n 3. 로컬 프로젝트 컨텍스트 사용:\n\n * 다음을 제공하여 로컬 작업 공간에서 작업합니다.\n * 작업 공간 루트 경로\n * Git 원격 URL\n * 지점 이름\n * 예: \"현재 분기에서 가장 최근에 실패한 파이프라인 찾기\"\n\n 이 도구는 다음을 포함한 형식화된 로그를 반환합니다.\n\n * 직업 이름\n * 단계별 실행 세부 정보\n * 실패 메시지 및 컨텍스트\n\n 이 기능은 다음과 같은 경우에 특히 유용합니다.\n\n * 실패한 빌드 디버깅\n * 테스트 실패 분석\n * 배포 문제 조사\n * IDE를 벗어나지 않고도 빌드 로그에 빠르게 액세스\n\n* `find_flaky_tests`\n\n 테스트 실행 기록을 분석하여 CircleCI 프로젝트에서 불안정한 테스트를 식별합니다. 이 기능은 에서 설명하는 불안정한 테스트 감지 기능을 활용합니다.\n\n 이 도구는 세 가지 방법으로 사용할 수 있습니다.\n\n 1. Project Slug 사용(권장 워크플로):\n\n * 먼저, 사용 가능한 프로젝트를 나열하세요.\n * list\\_followed\\_projects 도구를 사용하여 프로젝트를 가져옵니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n * 그런 다음 프로젝트와 연관된 projectSlug가 있는 프로젝트를 선택하세요.\n * 예: \"내 프로젝트를 사용해 보자\"\n * 그런 다음 불안정한 테스트를 검색하도록 요청합니다.\n * 예: \"내 프로젝트에 대한 불안정한 테스트 가져오기\"\n\n 2. CircleCI 프로젝트 URL 사용:\n\n * CircleCI에서 직접 프로젝트 URL을 제공하세요\n * 예: \" 에서 불안정한 테스트 찾기\"\n\n 3. 로컬 프로젝트 컨텍스트 사용:\n\n * 다음을 제공하여 로컬 작업 공간에서 작업합니다.\n * 작업 공간 루트 경로\n * Git 원격 URL\n * 예: \"현재 프로젝트에서 불안정한 테스트 찾기\"\n\n 이 도구는 다음을 포함하여 불안정한 테스트에 대한 자세한 정보를 반환합니다.\n\n * 테스트 이름 및 파일 위치\n * 실패 메시지 및 컨텍스트\n\n 이것은 당신에게 도움이 됩니다:\n\n * 테스트 모음에서 신뢰할 수 없는 테스트 식별\n * 테스트 실패에 대한 자세한 컨텍스트를 얻으세요\n * 테스트 개선에 대한 데이터 기반 의사 결정\n\n* `get_latest_pipeline_status`\n\n 지정된 브랜치의 최신 파이프라인 상태를 검색합니다. 이 도구는 세 가지 방법으로 사용할 수 있습니다.\n\n 1. Project Slug 및 Branch 사용(권장 워크플로):\n\n * 먼저, 사용 가능한 프로젝트를 나열하세요.\n * list\\_followed\\_projects 도구를 사용하여 프로젝트를 가져옵니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n * 그런 다음 프로젝트와 연관된 projectSlug가 있는 프로젝트를 선택하세요.\n * 예: \"내 프로젝트를 사용해 보자\"\n * 그런 다음 특정 분기의 최신 파이프라인 상태를 검색하도록 요청합니다.\n * 예: \"메인 브랜치에서 my-project의 최신 파이프라인 상태를 가져옵니다\"\n\n 2. CircleCI 프로젝트 URL 사용:\n\n * CircleCI에서 직접 프로젝트 URL을 제공하세요\n * 예: \" 에 대한 최신 파이프라인의 상태를 가져옵니다\"\n\n 3. 로컬 프로젝트 컨텍스트 사용:\n\n * 다음을 제공하여 로컬 작업 공간에서 작업합니다.\n * 작업 공간 루트 경로\n * Git 원격 URL\n * 지점 이름\n * 예: \"현재 프로젝트의 최신 파이프라인 상태 가져오기\"\n\n 이 도구는 최신 파이프라인의 형식화된 상태를 반환합니다.\n\n * 워크플로 이름 및 현재 상태\n * 각 워크플로의 기간\n * 생성 및 완료 타임스탬프\n * 전반적인 파이프라인 상태\n\n 출력 예:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n 이 기능은 특히 다음과 같은 경우에 유용합니다.\n\n * 최신 파이프라인 상태 확인\n * 특정 지점의 최신 파이프라인 상태 가져오기\n * IDE를 벗어나지 않고도 최신 파이프라인의 상태를 빠르게 확인하세요\n\n* `get_job_test_results`\n\n CircleCI 작업에 대한 테스트 메타데이터를 검색하여 IDE를 벗어나지 않고도 테스트 결과를 분석할 수 있도록 합니다. 이 도구는 세 가지 방법으로 사용할 수 있습니다.\n\n 1. Project Slug 및 Branch 사용(권장 워크플로):\n\n * 먼저, 사용 가능한 프로젝트를 나열하세요.\n * list\\_followed\\_projects 도구를 사용하여 프로젝트를 가져옵니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n * 그런 다음 프로젝트와 연관된 projectSlug가 있는 프로젝트를 선택하세요.\n * 예: \"내 프로젝트를 사용해 보자\"\n * 그런 다음 특정 지점에 대한 테스트 결과를 검색하도록 요청합니다.\n * 예: \"메인 브랜치에서 my-project에 대한 테스트 결과 가져오기\"\n\n 2. CircleCI URL 사용:\n\n * 다음 형식 중 하나로 CircleCI URL을 제공하세요.\n * 작업 URL: \" \"\n * 워크플로 URL: \" \"\n * 파이프라인 URL: \" \"\n * 예: \" 에 대한 테스트 결과 가져오기\"\n\n 3. 로컬 프로젝트 컨텍스트 사용:\n\n * 다음을 제공하여 로컬 작업 공간에서 작업합니다.\n * 작업 공간 루트 경로\n * Git 원격 URL\n * 지점 이름\n * 예: \"메인 브랜치에서 현재 프로젝트에 대한 테스트 결과를 가져옵니다\"\n\n 이 도구는 자세한 테스트 결과 정보를 반환합니다.\n\n * 모든 테스트 요약(전체, 성공, 실패)\n * 실패한 테스트에 대한 자세한 정보:\n * 테스트 이름 및 클래스\n * 파일 위치\n * 오류 메시지\n * 런타임 지속 시간\n * 타이밍 정보가 포함된 성공적인 테스트 목록\n * 테스트 결과로 필터링\n\n 이 기능은 특히 다음과 같은 경우에 유용합니다.\n\n * CircleCI 웹 UI를 방문하지 않고도 테스트 실패를 빠르게 분석\n * 테스트 실패 패턴 식별\n * 최적화가 필요할 수 있는 느린 테스트 찾기\n * 프로젝트 전체에서 테스트 범위 확인\n * 불안정한 테스트 문제 해결\n\n 참고: 이 도구를 사용하려면 CircleCI 설정에서 테스트 메타데이터가 올바르게 구성되어 있어야 합니다. 테스트 메타데이터 수집 설정에 대한 자세한 내용은 [https://circleci.com/docs/collect-test-data/를](https://circleci.com/docs/collect-test-data/) 참조하세요.\n\n* `config_helper`\n\n CircleCI 구성 작업에 대한 지침과 검증을 제공하여 도움을 줍니다. 이 도구는 다음과 같은 작업에 도움이 됩니다.\n\n 1. CircleCI 구성 검증:\n * .circleci/config.yml에서 구문 및 의미 오류를 확인합니다.\n * 예: \"CircleCI 구성 검증\"\n\n 이 도구는 다음을 제공합니다.\n\n * 자세한 검증 결과\n * 구성 권장 사항\n\n 이것은 당신에게 도움이 됩니다:\n\n * 푸시하기 전에 구성 오류를 잡아라\n * CircleCI 구성 모범 사례를 알아보세요\n * 구성 문제 해결\n * CircleCI 기능을 올바르게 구현하세요\n\n* `create_prompt_template`\n\n 기능 요구 사항을 기반으로 AI 지원 애플리케이션에 대한 체계적인 프롬프트 템플릿을 생성하는 데 도움이 됩니다. 이 도구는 다음을 수행합니다.\n\n 1. 기능 요구 사항을 구조화된 프롬프트로 변환합니다.\n * 사용자 요구 사항을 최적화된 프롬프트 템플릿으로 변환합니다.\n * 예: \"연령 및 주제에 따라 취침 시간 이야기를 생성하기 위한 프롬프트 템플릿 만들기\"\n\n 이 도구는 다음을 제공합니다.\n\n * 구조화된 프롬프트 템플릿\n * 필수 입력 매개변수를 정의하는 컨텍스트 스키마\n\n 이것은 당신에게 도움이 됩니다:\n\n * AI 애플리케이션을 위한 효과적인 프롬프트를 만듭니다.\n * 일관된 결과를 위해 입력 매개변수를 표준화합니다.\n * 강력한 AI 기반 기능 구축\n\n* `recommend_prompt_template_tests`\n\n 예상 결과가 생성되는지 확인하기 위해 즉각적인 템플릿에 대한 테스트 케이스를 생성합니다. 이 도구는 다음을 수행합니다.\n\n 1. 프롬프트 템플릿에 대한 테스트 케이스를 제공합니다.\n * 프롬프트 템플릿과 컨텍스트 스키마를 기반으로 다양한 테스트 시나리오를 생성합니다.\n * 예: \"취침 시간 이야기 프롬프트 템플릿에 대한 테스트 생성\"\n\n 이 도구는 다음을 제공합니다.\n\n * 추천되는 테스트 케이스의 배열\n * 템플릿 견고성을 테스트하기 위한 다양한 매개변수 조합\n\n 이것은 당신에게 도움이 됩니다:\n\n * 프롬프트 템플릿 기능 검증\n * 입력 전반에 걸쳐 일관된 AI 응답을 보장합니다.\n * 에지 케이스와 잠재적인 문제 식별\n * 전반적인 AI 애플리케이션 품질 개선\n\n* `list_followed_projects`\n\n CircleCI에서 사용자가 팔로우하는 모든 프로젝트를 나열합니다. 이 도구는 다음을 수행합니다.\n\n 1. 프로젝트 검색 및 표시:\n * 사용자가 액세스할 수 있고 팔로우하고 있는 모든 프로젝트를 표시합니다.\n * 각 항목에 대한 프로젝트 이름과 projectSlug를 제공합니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n\n 이 도구는 프로젝트의 형식화된 목록을 반환합니다. 출력 예는 다음과 같습니다.\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n 이 기능은 특히 다음과 같은 경우에 유용합니다.\n\n * 귀하가 사용할 수 있는 CircleCI 프로젝트 식별\n * 다른 CircleCI 도구에 필요한 projectSlug 얻기\n * 후속 작업을 위한 프로젝트 선택\n\n 참고: projectSlug(프로젝트 이름이 아님)는 다른 여러 CircleCI 도구에 필요하며, 프로젝트를 선택한 후 해당 도구 호출에 사용됩니다.\n\n* `run_pipeline`\n\n 파이프라인을 실행합니다. 이 도구는 세 가지 방법으로 사용할 수 있습니다.\n\n 1. Project Slug 및 Branch 사용(권장 워크플로):\n\n * 먼저, 사용 가능한 프로젝트를 나열하세요.\n * list\\_followed\\_projects 도구를 사용하여 프로젝트를 가져옵니다.\n * 예: \"내 CircleCI 프로젝트 나열\"\n * 그런 다음 프로젝트와 연관된 projectSlug가 있는 프로젝트를 선택하세요.\n * 예: \"내 프로젝트를 사용해 보자\"\n * 그런 다음 특정 분기에 대한 파이프라인을 실행하도록 요청합니다.\n * 예: \"메인 브랜치에서 my-project에 대한 파이프라인을 실행하세요\"\n\n 2. CircleCI URL 사용:\n\n * 다음 형식 중 하나로 CircleCI URL을 제공하세요.\n * 작업 URL: \" \"\n * 워크플로 URL: \" \"\n * 파이프라인 URL: \" \"\n * 브랜치가 있는 프로젝트 URL: \" \"\n * 예: \" 에 대한 파이프라인을 실행합니다.\"\n\n 3. 로컬 프로젝트 컨텍스트 사용:\n\n * 다음을 제공하여 로컬 작업 공간에서 작업합니다.\n * 작업 공간 루트 경로\n * Git 원격 URL\n * 지점 이름\n * 예: \"메인 브랜치에서 현재 프로젝트의 파이프라인을 실행합니다\"\n\n 이 도구는 파이프라인 실행을 모니터링하기 위한 링크를 반환합니다.\n\n 이 기능은 다음과 같은 경우에 특히 유용합니다.\n\n * CircleCI 웹 UI를 방문하지 않고도 파이프라인을 빠르게 실행합니다.\n * 특정 지점에서 파이프라인 실행\n\n# 개발\n\n## 시작하기\n\n1. 저장소를 복제합니다.\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. 종속성 설치:\n\n ```bash\n pnpm install\n ```\n\n3. 프로젝트를 빌드하세요:\n\n ```bash\n pnpm build\n ```\n\n## Docker 컨테이너 빌드\n\n다음을 사용하여 Docker 컨테이너를 로컬로 빌드할 수 있습니다.\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\n이렇게 하면 MCP 클라이언트에서 사용할 수 있는 `circleci:mcp-server-circleci` 라는 태그가 지정된 Docker 이미지가 생성됩니다.\n\n컨테이너를 실행하려면:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## MCP Inspector를 활용한 개발\n\nMCP 서버에서 반복 작업을 수행하는 가장 쉬운 방법은 MCP 검사기를 사용하는 것입니다. MCP 검사기에 대한 자세한 내용은 에서 확인할 수 있습니다.\n\n1. 개발 서버를 시작합니다.\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. 별도의 터미널에서 검사기를 실행합니다.\n\n ```bash\n pnpm inspector\n ```\n\n3. 환경 구성:\n\n * 검사기 UI의 환경 변수 섹션에 `CIRCLECI_TOKEN` 추가합니다.\n * 토큰에는 CircleCI 프로젝트에 대한 읽기 액세스 권한이 필요합니다.\n * 선택적으로 CircleCI 기본 URL을 설정할 수 있습니다. 기본값은 `https//circleci.com` 입니다.\n\n## 테스트\n\n* 테스트 모음을 실행합니다.\n\n ```bash\n pnpm test\n ```\n\n* 개발 중에 감시 모드에서 테스트를 실행합니다.\n\n ```bash\n pnpm test:watch\n ```\n\n더 자세한 기여 지침은 [CONTRIBUTING.md를](CONTRIBUTING.md) 참조하세요.","Korean","ko-KR",{"_29":65,"_33":69,"_38":70},{"_31":66,"_33":67,"_35":68},"Этот сервер MCP позволяет использовать Cursor IDE или любой агент с поддержкой MCP Client, чтобы использовать естественный язык для выполнения задач с CircleCI, например: найти последний неисправный конвейер в моей ветке и получить журналы.","mcp-сервер-circleci","# Сервер CircleCI MCP\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![нпм](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\nModel Context Protocol (MCP) — это [новый стандартизированный протокол](https://modelcontextprotocol.io/introduction) для управления контекстом между большими языковыми моделями (LLM) и внешними системами. В этом репозитории мы предоставляем MCP Server для [CircleCI](https://circleci.com) .\n\nЭто позволяет использовать Cursor IDE, Windsurf, Copilot или любой клиент с поддержкой MCP, чтобы использовать естественный язык для выполнения задач с CircleCI, например:\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## Требования\n\n* Токен API CircleCI — вы можете сгенерировать его через CircleCI. [Узнайте больше](https://circleci.com/docs/managing-api-tokens/) или [нажмите здесь](https://app.circleci.com/settings/user/tokens) для быстрого доступа.\n\nДля установки NPX:\n\n* Менеджер пакетов pnpm - [Узнать больше](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\nДля установки Docker:\n\n* Докер - [Узнать больше](https://docs.docker.com/get-docker/)\n\n## Установка\n\n### Курсор\n\n#### Использование NPX\n\nДобавьте следующее в конфигурацию MCP курсора:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Использование Докера\n\nДобавьте следующее в конфигурацию MCP курсора:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### Код VS\n\n#### Использование NPX\n\nЧтобы установить CircleCI MCP Server для VS Code в `.vscode/mcp.json` :\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### Использование Докера\n\nЧтобы установить CircleCI MCP Server для VS Code в `.vscode/mcp.json` с помощью Docker:\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### Клод Десктоп\n\n#### Использование NPX\n\nДобавьте следующее в ваш claude\\_desktop\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Использование Докера\n\nДобавьте следующее в ваш claude\\_desktop\\_config.json:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nЧтобы найти/создать этот файл, сначала откройте настройки рабочего стола claude. Затем нажмите «Разработчик» в левой панели панели настроек, а затем нажмите «Изменить конфигурацию»\n\nЭто создаст файл конфигурации по адресу:\n\n* macOS: ~/Library/Application Support/Claude/claude\\_desktop\\_config.json\n* Windows: %APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\nДополнительную информацию об использовании серверов MCP с Claude Desktop см. в руководстве ниже: \n\n### Клод Код\n\n#### Использование NPX\n\nПосле установки Claude Code выполните следующую команду:\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### Использование Докера\n\nПосле установки Claude Code выполните следующую команду:\n\n```bash\nclaude 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\n```\n\nДополнительную информацию об использовании серверов MCP с Claude Code см. в руководстве ниже: \n\n### Виндсерфинг\n\n#### Использование NPX\n\nДобавьте следующее в ваш mcp\\_config.json windsurf:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### Использование Докера\n\nДобавьте следующее в ваш mcp\\_config.json windsurf:\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\nДополнительную информацию об использовании серверов MCP с Windsurf смотрите в руководстве ниже: \n\n### Установка через Smithery\n\nЧтобы автоматически установить CircleCI MCP Server для Claude Desktop через [Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci) :\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# Функции\n\n## Поддерживаемые инструменты\n\n* `get_build_failure_logs`\n\n Извлекает подробные журналы сбоев из сборок CircleCI. Этот инструмент можно использовать тремя способами:\n\n 1. Использование Project Slug и Branch (рекомендуемый рабочий процесс):\n\n * Сначала перечислите доступные вам проекты:\n * Используйте инструмент list\\_followed\\_projects для получения ваших проектов\n * Пример: «Список моих проектов CircleCI»\n * Затем выберите проект, с которым связан projectSlug.\n * Пример: «Давайте использовать мой проект»\n * Затем попросите извлечь журналы сбоев сборки для определенной ветки:\n * Пример: «Получить сведения об ошибках сборки для моего проекта в основной ветке»\n\n 2. Использование URL-адресов CircleCI:\n\n * Укажите URL-адрес невыполненного задания или URL-адрес конвейера напрямую\n * Пример: «Получить логи с »\n\n 3. Использование локального контекста проекта:\n\n * Работает из вашего локального рабочего пространства, предоставляя:\n * Корневой путь к рабочему пространству\n * Удаленный URL-адрес Git\n * Название филиала\n * Пример: «Найти последний неисправный конвейер в моей текущей ветке»\n\n Инструмент возвращает отформатированные журналы, включая:\n\n * Названия должностей\n * Пошаговые детали выполнения\n * Сообщения об ошибках и контекст\n\n Это особенно полезно для:\n\n * Отладка неудачных сборок\n * Анализ неудачных тестов\n * Исследование проблем развертывания\n * Быстрый доступ к журналам сборки, не выходя из IDE\n\n* `find_flaky_tests`\n\n Выявляет нестабильные тесты в вашем проекте CircleCI, анализируя историю выполнения тестов. Это использует функцию обнаружения нестабильных тестов, описанную здесь: \n\n Этот инструмент можно использовать тремя способами:\n\n 1. Использование Project Slug (рекомендуемый рабочий процесс):\n\n * Сначала перечислите доступные вам проекты:\n * Используйте инструмент list\\_followed\\_projects для получения ваших проектов\n * Пример: «Список моих проектов CircleCI»\n * Затем выберите проект, с которым связан projectSlug.\n * Пример: «Давайте использовать мой проект»\n * Затем попросите восстановить нестабильные тесты:\n * Пример: «Получить нестабильные тесты для моего проекта»\n\n 2. Используя URL-адрес проекта CircleCI:\n\n * Предоставьте URL-адрес проекта напрямую из CircleCI\n * Пример: «Найдите нестабильные тесты в »\n\n 3. Использование локального контекста проекта:\n\n * Работает из вашего локального рабочего пространства, предоставляя:\n * Корневой путь к рабочему пространству\n * Удаленный URL-адрес Git\n * Пример: «Найти ненадёжные тесты в моём текущем проекте»\n\n Инструмент возвращает подробную информацию о ненадежных тестах, включая:\n\n * Тестовые имена и местоположения файлов\n * Сообщения об ошибках и контексты\n\n Это поможет вам:\n\n * Определите ненадежные тесты в вашем тестовом наборе\n * Получите подробный контекст о неудачных тестах\n * Принимайте решения об улучшении тестов на основе данных\n\n* `get_latest_pipeline_status`\n\n Извлекает статус последнего конвейера для заданной ветки. Этот инструмент можно использовать тремя способами:\n\n 1. Использование Project Slug и Branch (рекомендуемый рабочий процесс):\n\n * Сначала перечислите доступные вам проекты:\n * Используйте инструмент list\\_followed\\_projects для получения ваших проектов\n * Пример: «Список моих проектов CircleCI»\n * Затем выберите проект, с которым связан projectSlug.\n * Пример: «Давайте использовать мой проект»\n * Затем попросите получить последний статус конвейера для определенной ветки:\n * Пример: «Получить статус последнего конвейера для моего проекта на основной ветке»\n\n 2. Используя URL-адрес проекта CircleCI:\n\n * Предоставьте URL-адрес проекта напрямую из CircleCI\n * Пример: «Получить статус последнего конвейера для »\n\n 3. Использование локального контекста проекта:\n\n * Работает из вашего локального рабочего пространства, предоставляя:\n * Корневой путь к рабочему пространству\n * Удаленный URL-адрес Git\n * Название филиала\n * Пример: «Получить статус последнего конвейера для моего текущего проекта»\n\n Инструмент возвращает отформатированный статус последнего конвейера:\n\n * Названия рабочих процессов и их текущий статус\n * Продолжительность каждого рабочего процесса\n * Временные метки создания и завершения\n * Общее состояние трубопровода\n\n Пример вывода:\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n Это особенно полезно для:\n\n * Проверка статуса последнего трубопровода\n * Получение статуса последнего конвейера для определенной ветки\n * Быстрая проверка статуса последнего конвейера, не выходя из IDE\n\n* `get_job_test_results`\n\n Извлекает метаданные теста для заданий CircleCI, позволяя вам анализировать результаты теста, не покидая IDE. Этот инструмент можно использовать тремя способами:\n\n 1. Использование Project Slug и Branch (рекомендуемый рабочий процесс):\n\n * Сначала перечислите доступные вам проекты:\n * Используйте инструмент list\\_followed\\_projects для получения ваших проектов\n * Пример: «Список моих проектов CircleCI»\n * Затем выберите проект, с которым связан projectSlug.\n * Пример: «Давайте использовать мой проект»\n * Затем попросите выслать результаты теста по определенному филиалу:\n * Пример: «Получить результаты тестирования для моего проекта на основной ветке»\n\n 2. Используя URL-адрес CircleCI:\n\n * Укажите URL-адрес CircleCI в любом из следующих форматов:\n * URL-адрес задания: \" \"\n * URL рабочего процесса: \" \"\n * URL-адрес конвейера: \" \"\n * Пример: «Получить результаты теста для »\n\n 3. Использование локального контекста проекта:\n\n * Работает из вашего локального рабочего пространства, предоставляя:\n * Корневой путь к рабочему пространству\n * Удаленный URL-адрес Git\n * Название филиала\n * Пример: «Получить результаты тестирования моего текущего проекта в основной ветке»\n\n Инструмент возвращает подробную информацию о результатах теста:\n\n * Сводка всех тестов (всего, успешных, неудачных)\n * Подробная информация о неудачных тестах, включая:\n * Название и класс теста\n * Расположение файла\n * Сообщения об ошибках\n * Продолжительность выполнения\n * Список успешных испытаний с указанием времени\n * Фильтр по результатам тестов\n\n Это особенно полезно для:\n\n * Быстрый анализ сбоев тестирования без посещения веб-интерфейса CircleCI\n * Выявление закономерностей в неудачных тестах\n * Поиск медленных тестов, которые могут нуждаться в оптимизации\n * Проверка тестового покрытия вашего проекта\n * Устранение неполадок в нестабильных тестах\n\n Примечание: инструмент требует, чтобы тестовые метаданные были правильно настроены в вашей конфигурации CircleCI. Для получения дополнительной информации о настройке сбора тестовых метаданных см.: \n\n* `config_helper`\n\n Помогает с задачами конфигурации CircleCI, предоставляя руководство и проверку. Этот инструмент помогает вам:\n\n 1. Проверьте конфигурацию CircleCI:\n * Проверяет ваш .circleci/config.yml на наличие синтаксических и семантических ошибок\n * Пример: «Проверьте мою конфигурацию CircleCI»\n\n Инструмент обеспечивает:\n\n * Подробные результаты проверки\n * Рекомендации по конфигурации\n\n Это поможет вам:\n\n * Отслеживайте ошибки конфигурации перед отправкой\n * Изучите передовой опыт конфигурации CircleCI\n * Устранение неполадок конфигурации\n * Правильно реализуйте функции CircleCI\n\n* `create_prompt_template`\n\n Помогает генерировать структурированные шаблоны подсказок для приложений с поддержкой ИИ на основе требований к функциям. Этот инструмент:\n\n 1. Преобразует требования к функциям в структурированные подсказки:\n * Преобразует требования пользователя в оптимизированные шаблоны подсказок\n * Пример: «Создать шаблон подсказок для создания сказок на ночь по возрасту и теме»\n\n Инструмент обеспечивает:\n\n * Структурированный шаблон подсказки\n * Контекстная схема, определяющая требуемые входные параметры\n\n Это поможет вам:\n\n * Создавайте эффективные подсказки для приложений ИИ\n * Стандартизируйте входные параметры для получения единообразных результатов\n * Создавайте надежные функции на базе искусственного интеллекта\n\n* `recommend_prompt_template_tests`\n\n Создает тестовые случаи для шаблонов подсказок, чтобы убедиться, что они дают ожидаемые результаты. Этот инструмент:\n\n 1. Предоставляет тестовые примеры для шаблонов подсказок:\n * Создает разнообразные тестовые сценарии на основе вашего шаблона подсказки и контекстной схемы.\n * Пример: «Создать тесты для моего шаблона подсказок для чтения сказки на ночь»\n\n Инструмент обеспечивает:\n\n * Массив рекомендуемых тестовых случаев\n * Различные комбинации параметров для проверки надежности шаблона\n\n Это поможет вам:\n\n * Проверить функциональность шаблона подсказки\n * Обеспечьте единообразие ответов ИИ на все входные данные\n * Определите пограничные случаи и потенциальные проблемы\n * Улучшить общее качество приложений ИИ\n\n* `list_followed_projects`\n\n Список всех проектов, за которыми пользователь следит на CircleCI. Этот инструмент:\n\n 1. Извлекает и отображает проекты:\n * Показывает все проекты, к которым пользователь имеет доступ и за которыми следит\n * Предоставляет название проекта и projectSlug для каждой записи\n * Пример: «Список моих проектов CircleCI»\n\n Инструмент возвращает отформатированный список проектов, пример вывода:\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n Это особенно полезно для:\n\n * Определение доступных вам проектов CircleCI\n * Получение projectSlug, необходимого для других инструментов CircleCI\n * Выбор проекта для последующих операций\n\n Примечание: projectSlug (не имя проекта) требуется для многих других инструментов CircleCI и будет использоваться для вызовов этих инструментов после выбора проекта.\n\n* `run_pipeline`\n\n Запускает конвейер. Этот инструмент можно использовать тремя способами:\n\n 1. Использование Project Slug и Branch (рекомендуемый рабочий процесс):\n\n * Сначала перечислите доступные вам проекты:\n * Используйте инструмент list\\_followed\\_projects для получения ваших проектов\n * Пример: «Список моих проектов CircleCI»\n * Затем выберите проект, с которым связан projectSlug.\n * Пример: «Давайте использовать мой проект»\n * Затем попросите запустить конвейер для определенной ветки:\n * Пример: «Запустить конвейер для моего проекта на основной ветке»\n\n 2. Используя URL-адрес CircleCI:\n\n * Укажите URL-адрес CircleCI в любом из следующих форматов:\n * URL-адрес задания: \" \"\n * URL рабочего процесса: \" \"\n * URL-адрес конвейера: \" \"\n * URL проекта с веткой: \" \"\n * Пример: «Запустить конвейер для »\n\n 3. Использование локального контекста проекта:\n\n * Работает из вашего локального рабочего пространства, предоставляя:\n * Корневой путь к рабочему пространству\n * Удаленный URL-адрес Git\n * Название филиала\n * Пример: «Запустить конвейер для моего текущего проекта на основной ветке»\n\n Инструмент возвращает ссылку для мониторинга выполнения конвейера.\n\n Это особенно полезно для:\n\n * Быстрый запуск конвейеров без посещения веб-интерфейса CircleCI\n * Прокладка трубопроводов из определенной ветки\n\n# Разработка\n\n## Начиная\n\n1. Клонируйте репозиторий:\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. Установить зависимости:\n\n ```bash\n pnpm install\n ```\n\n3. Создайте проект:\n\n ```bash\n pnpm build\n ```\n\n## Создание Docker-контейнера\n\nВы можете создать Docker-контейнер локально, используя:\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\nЭто создаст образ Docker с тегом `circleci:mcp-server-circleci` , который можно использовать с любым клиентом MCP.\n\nЧтобы запустить контейнер:\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## Разработка с помощью MCP Inspector\n\nСамый простой способ итерации на сервере MCP — использовать инспектор MCP. Узнать больше об инспекторе MCP можно по ссылке \n\n1. Запустите сервер разработки:\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. В отдельном терминале запустите инспектор:\n\n ```bash\n pnpm inspector\n ```\n\n3. Настройте среду:\n\n * Добавьте свой `CIRCLECI_TOKEN` в раздел «Переменные среды» в пользовательском интерфейсе инспектора.\n * Токену необходим доступ на чтение к вашим проектам CircleCI.\n * При желании вы можете задать свой базовый URL CircleCI. По умолчанию `https//circleci.com`\n\n## Тестирование\n\n* Запустите тестовый набор:\n\n ```bash\n pnpm test\n ```\n\n* Запустите тесты в режиме наблюдения во время разработки:\n\n ```bash\n pnpm test:watch\n ```\n\nБолее подробные правила по внесению взносов см. на [сайте CONTRIBUTING.md](CONTRIBUTING.md)","Russian","ru-RU",{"_29":72,"_33":76,"_38":77},{"_31":73,"_33":74,"_35":75},"此 MCP 服务器允许您使用 Cursor IDE 或任何启用 MCP 客户端的代理，使用自然语言通过 CircleCI 完成操作，例如：在我的分支上查找最新失败的管道并获取日志","mcp-服务器-circleci","# CircleCI MCP 服务器\n\n[![GitHub](https://img.shields.io/github/license/CircleCI-Public/mcp-server-circleci)](https://github.com/CircleCI-Public/mcp-server-circleci/blob/main/LICENSE) [![CircleCI](https://dl.circleci.com/status-badge/img/gh/CircleCI-Public/mcp-server-circleci/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/CircleCI-Public/mcp-server-circleci/tree/main) [![npm](https://img.shields.io/npm/v/@circleci/mcp-server-circleci?logo=npm)](https://www.npmjs.com/package/@circleci/mcp-server-circleci)\n\n模型上下文协议 (MCP) 是一种[新的标准化协议，](https://modelcontextprotocol.io/introduction)用于管理大型语言模型 (LLM) 与外部系统之间的上下文。在此存储库中，我们为[CircleCI](https://circleci.com)提供了一个 MCP 服务器。\n\n这使您可以使用 Cursor IDE、Windsurf、Copilot 或任何 MCP 支持的客户端，使用自然语言通过 CircleCI 完成任务，例如：\n\n* `Find the latest failed pipeline on my branch and get logs`\n\n\n\n## 要求\n\n* CircleCI API 令牌 - 您可以通过 CircleCI 生成一个。[了解更多](https://circleci.com/docs/managing-api-tokens/)或[点击此处](https://app.circleci.com/settings/user/tokens)快速访问。\n\n对于 NPX 安装：\n\n* pnpm 包管理器 -[了解更多](https://pnpm.io/installation)\n* Node.js >= v18.0.0\n\n对于 Docker 安装：\n\n* Docker -[了解更多](https://docs.docker.com/get-docker/)\n\n## 安装\n\n### 光标\n\n#### 使用 NPX\n\n将以下内容添加到您的游标 MCP 配置中：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### 使用 Docker\n\n将以下内容添加到您的游标 MCP 配置中：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n### VS 代码\n\n#### 使用 NPX\n\n要在`.vscode/mcp.json`中为 VS Code 安装 CircleCI MCP 服务器：\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n#### 使用 Docker\n\n使用 Docker 在`.vscode/mcp.json`中安装 CircleCI MCP Server for VS Code：\n\n```json\n{\n // 💡 Inputs are prompted on first server start, then stored securely by VS Code.\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-token\",\n \"description\": \"CircleCI API Token\",\n \"password\": true\n },\n {\n \"type\": \"promptString\",\n \"id\": \"circleci-base-url\",\n \"description\": \"CircleCI Base URL\",\n \"default\": \"https://circleci.com\"\n }\n ],\n \"servers\": {\n // https://github.com/ppl-ai/modelcontextprotocol/\n \"circleci-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"${input:circleci-token}\",\n \"CIRCLECI_BASE_URL\": \"${input:circleci-base-url}\"\n }\n }\n }\n}\n```\n\n### 克劳德桌面\n\n#### 使用 NPX\n\n将以下内容添加到您的 claude\\_desktop\\_config.json：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### 使用 Docker\n\n将以下内容添加到您的 claude\\_desktop\\_config.json：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n要查找/创建此文件，首先打开 Claude 桌面设置。然后点击“设置”面板左侧栏中的“开发者”，然后点击“编辑配置”。\n\n这将在以下位置创建一个配置文件：\n\n* macOS：~/Library/Application Support/Claude/claude\\_desktop\\_config.json\n* Windows：%APPDATA%\\Claude\\claude\\_desktop\\_config.json\n\n有关使用 MCP 服务器和 Claude Desktop 的更多信息，请参阅以下指南： \n\n### 克劳德·科德\n\n#### 使用 NPX\n\n安装Claude Code后，运行以下命令：\n\n```bash\nclaude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx -y @circleci/mcp-server-circleci\n```\n\n#### 使用 Docker\n\n安装Claude Code后，运行以下命令：\n\n```bash\nclaude 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\n```\n\n有关使用 Claude Code 的 MCP 服务器的更多信息，请参阅以下指南： \n\n### 风帆冲浪\n\n#### 使用 NPX\n\n将以下内容添加到您的 windsurf mcp\\_config.json：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@circleci/mcp-server-circleci\"],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n#### 使用 Docker\n\n将以下内容添加到您的 windsurf mcp\\_config.json：\n\n```json\n{\n \"mcpServers\": {\n \"circleci-mcp-server\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-e\", \"CIRCLECI_TOKEN\",\n \"-e\", \"CIRCLECI_BASE_URL\",\n \"circleci:mcp-server-circleci\"\n ],\n \"env\": {\n \"CIRCLECI_TOKEN\": \"your-circleci-token\",\n \"CIRCLECI_BASE_URL\": \"https://circleci.com\" // Optional - required for on-prem customers only\n }\n }\n }\n}\n```\n\n有关使用 MCP 服务器和 windsurf 的更多信息，请参阅以下指南： \n\n### 通过 Smithery 安装\n\n要通过[Smithery](https://smithery.ai/server/@CircleCI-Public/mcp-server-circleci)自动为 Claude Desktop 安装 CircleCI MCP 服务器：\n\n```bash\nnpx -y @smithery/cli install @CircleCI-Public/mcp-server-circleci --client claude\n```\n\n# 特征\n\n## 支持的工具\n\n* `get_build_failure_logs`\n\n 从 CircleCI 构建中检索详细的失败日志。此工具有三种使用方式：\n\n 1. 使用项目 Slug 和 Branch（推荐的工作流程）：\n\n * 首先，列出您可用的项目：\n * 使用 list\\_followed\\_projects 工具获取您的项目\n * 例如：“列出我的 CircleCI 项目”\n * 然后选择与之关联的 projectSlug 项目\n * 例如：“让我们使用我的项目”\n * 然后请求检索特定分支的构建失败日志：\n * 示例：“获取主分支上我的项目的构建失败信息”\n\n 2. 使用 CircleCI URL：\n\n * 直接提供失败的作业 URL 或管道 URL\n * 示例：“从获取日志”\n\n 3. 使用本地项目上下文：\n\n * 通过提供以下内容从您的本地工作区工作：\n * 工作区根路径\n * Git 远程 URL\n * 分支机构名称\n * 示例：“查找当前分支上最新的失败管道”\n\n 该工具返回格式化的日志，包括：\n\n * 职位名称\n * 逐步执行细节\n * 失败消息和上下文\n\n 这对于以下情况尤其有用：\n\n * 调试失败的构建\n * 分析测试失败\n * 调查部署问题\n * 无需离开 IDE 即可快速访问构建日志\n\n* `find_flaky_tests`\n\n 通过分析测试执行历史记录，识别 CircleCI 项目中的不稳定测试。这利用了此处描述的不稳定测试检测功能： \n\n 此工具有三种使用方式：\n\n 1. 使用 Project Slug（推荐工作流程）：\n\n * 首先，列出您可用的项目：\n * 使用 list\\_followed\\_projects 工具获取您的项目\n * 例如：“列出我的 CircleCI 项目”\n * 然后选择与之关联的 projectSlug 项目\n * 例如：“让我们使用我的项目”\n * 然后请求检索不稳定的测试：\n * 例如：“获取我的项目的不稳定测试”\n\n 2. 使用 CircleCI 项目 URL：\n\n * 直接从 CircleCI 提供项目 URL\n * 示例：“在中查找不稳定的测试”\n\n 3. 使用本地项目上下文：\n\n * 通过提供以下内容从您的本地工作区工作：\n * 工作区根路径\n * Git 远程 URL\n * 例如：“查找当前项目中的不稳定测试”\n\n 该工具返回有关不稳定测试的详细信息，包括：\n\n * 测试名称和文件位置\n * 失败消息和上下文\n\n 这可以帮助您：\n\n * 识别测试套件中不可靠的测试\n * 获取有关测试失败的详细背景信息\n * 做出有关测试改进的数据驱动决策\n\n* `get_latest_pipeline_status`\n\n 检索给定分支的最新管道状态。此工具有三种使用方式：\n\n 1. 使用项目 Slug 和 Branch（推荐的工作流程）：\n\n * 首先，列出您可用的项目：\n * 使用 list\\_followed\\_projects 工具获取您的项目\n * 例如：“列出我的 CircleCI 项目”\n * 然后选择与之关联的 projectSlug 项目\n * 例如：“让我们使用我的项目”\n * 然后要求检索特定分支的最新管道状态：\n * 示例：“获取主分支上我的项目的最新管道状态”\n\n 2. 使用 CircleCI 项目 URL：\n\n * 直接从 CircleCI 提供项目 URL\n * 示例：“获取的最新管道状态”\n\n 3. 使用本地项目上下文：\n\n * 通过提供以下内容从您的本地工作区工作：\n * 工作区根路径\n * Git 远程 URL\n * 分支机构名称\n * 示例：“获取我当前项目的最新管道状态”\n\n 该工具返回最新管道的格式化状态：\n\n * 工作流名称及其当前状态\n * 每个工作流程的持续时间\n * 创建和完成时间戳\n * 管道总体健康状况\n\n 示例输出：\n\n ```\n ---\n Workflow: build\n Status: success\n Duration: 5 minutes\n Created: 4/20/2025, 10:15:30 AM\n Stopped: 4/20/2025, 10:20:45 AM\n ---\n Workflow: test\n Status: running\n Duration: unknown\n Created: 4/20/2025, 10:21:00 AM\n Stopped: in progress\n ```\n\n 这对于以下情况尤其有用：\n\n * 检查最新管道的状态\n * 获取特定分支的最新管道状态\n * 无需离开 IDE 即可快速检查最新管道的状态\n\n* `get_job_test_results`\n\n 检索 CircleCI 作业的测试元数据，让您无需离开 IDE 即可分析测试结果。此工具有三种使用方式：\n\n 1. 使用项目 Slug 和 Branch（推荐的工作流程）：\n\n * 首先，列出你可用的项目：\n * 使用 list\\_followed\\_projects 工具获取您的项目\n * 例如：“列出我的 CircleCI 项目”\n * 然后选择与之关联的 projectSlug 项目\n * 例如：“让我们使用我的项目”\n * 然后要求检索特定分支的测试结果：\n * 示例：“获取主分支上我的项目的测试结果”\n\n 2. 使用 CircleCI URL：\n\n * 提供以下任意格式的 CircleCI URL：\n * 职位网址：“ ”\n * 工作流程 URL：“ ”\n * 管道 URL：“ ”\n * 示例：“获取的测试结果”\n\n 3. 使用本地项目上下文：\n\n * 通过提供以下内容从您的本地工作区工作：\n * 工作区根路径\n * Git 远程 URL\n * 分支机构名称\n * 示例：“获取主分支上当前项目的测试结果”\n\n 该工具返回详细的测试结果信息：\n\n * 所有测试的摘要（总计、成功、失败）\n * 有关失败测试的详细信息包括：\n * 测试名称和类别\n * 文件位置\n * 错误消息\n * 运行时间\n * 包含时间信息的成功测试列表\n * 按测试结果过滤\n\n 这对于以下情况尤其有用：\n\n * 无需访问 CircleCI Web UI 即可快速分析测试失败\n * 识别测试失败的模式\n * 查找可能需要优化的慢速测试\n * 检查整个项目的测试覆盖率\n * 解决不稳定测试问题\n\n 注意：该工具要求您在 CircleCI 配置中正确配置测试元数据。有关设置测试元数据收集的更多信息，请参阅： [https](https://circleci.com/docs/collect-test-data/) ://circleci.com/docs/collect-test-data/\n\n* `config_helper`\n\n 通过提供指导和验证来协助完成 CircleCI 配置任务。此工具可帮助您：\n\n 1. 验证 CircleCI 配置：\n * 检查你的 .circleci/config.yml 是否存在语法和语义错误\n * 示例：“验证我的 CircleCI 配置”\n\n 该工具提供：\n\n * 详细验证结果\n * 配置建议\n\n 这可以帮助您：\n\n * 推送之前捕获配置错误\n * 了解 CircleCI 配置最佳实践\n * 解决配置问题\n * 正确实现 CircleCI 功能\n\n* `create_prompt_template`\n\n 根据功能需求，帮助为支持 AI 的应用程序生成结构化的提示模板。此工具：\n\n 1. 将功能需求转换为结构化提示：\n * 将用户需求转化为优化的提示模板\n * 示例：“创建一个按年龄和主题生成睡前故事的提示模板”\n\n 该工具提供：\n\n * 结构化的提示模板\n * 定义所需输入参数的上下文模式\n\n 这可以帮助您：\n\n * 为人工智能应用程序创建有效的提示\n * 标准化输入参数以获得一致的结果\n * 构建强大的 AI 驱动功能\n\n* `recommend_prompt_template_tests`\n\n 为提示模板生成测试用例，以确保其产生预期结果。此工具：\n\n 1. 提供提示模板的测试用例：\n * 根据提示模板和上下文模式创建不同的测试场景\n * 示例：“为我的睡前故事提示模板生成测试”\n\n 该工具提供：\n\n * 一系列推荐的测试用例\n * 多种参数组合来测试模板鲁棒性\n\n 这可以帮助您：\n\n * 验证提示模板功能\n * 确保 AI 对输入做出一致的响应\n * 识别边缘情况和潜在问题\n * 提升整体人工智能应用质量\n\n* `list_followed_projects`\n\n 列出用户在 CircleCI 上关注的所有项目。此工具：\n\n 1. 检索并显示项目：\n * 显示用户有权访问和关注的所有项目\n * 为每个条目提供项目名称和 projectSlug\n * 例如：“列出我的 CircleCI 项目”\n\n 该工具返回项目的格式化列表，示例输出：\n\n ```\n Projects followed:\n 1. my-project (projectSlug: gh/organization/my-project)\n 2. another-project (projectSlug: gh/organization/another-project)\n ```\n\n 这对于以下情况尤其有用：\n\n * 确定哪些 CircleCI 项目可供您使用\n * 获取其他 CircleCI 工具所需的 projectSlug\n * 选择后续操作的项目\n\n 注意：许多其他 CircleCI 工具都需要 projectSlug（不是项目名称），并且将在选择项目后用于这些工具调用。\n\n* `run_pipeline`\n\n 触发管道运行。此工具有三种使用方式：\n\n 1. 使用项目 Slug 和 Branch（推荐的工作流程）：\n\n * 首先，列出你可用的项目：\n * 使用 list\\_followed\\_projects 工具获取您的项目\n * 例如：“列出我的 CircleCI 项目”\n * 然后选择与之关联的 projectSlug 项目\n * 例如：“让我们使用我的项目”\n * 然后要求针对特定分支运行管道：\n * 示例：“在主分支上运行 my-project 的管道”\n\n 2. 使用 CircleCI URL：\n\n * 提供以下任意格式的 CircleCI URL：\n * 职位网址：“ ”\n * 工作流程 URL：“ ”\n * 管道 URL：“ ”\n * 包含分支的项目 URL：“ ”\n * 示例：“运行的管道”\n\n 3. 使用本地项目上下文：\n\n * 通过提供以下内容从您的本地工作区工作：\n * 工作区根路径\n * Git 远程 URL\n * 分支机构名称\n * 示例：“在主分支上运行我当前项目的管道”\n\n 该工具返回一个链接来监视管道的执行情况。\n\n 这对于以下情况尤其有用：\n\n * 无需访问 CircleCI Web UI 即可快速运行管道\n * 从特定分支运行管道\n\n# 发展\n\n## 入门\n\n1. 克隆存储库：\n\n ```bash\n git clone https://github.com/CircleCI-Public/mcp-server-circleci.git\n cd mcp-server-circleci\n ```\n\n2. 安装依赖项：\n\n ```bash\n pnpm install\n ```\n\n3. 构建项目：\n\n ```bash\n pnpm build\n ```\n\n## 构建 Docker 容器\n\n您可以使用以下方式在本地构建 Docker 容器：\n\n```bash\ndocker build -t circleci:mcp-server-circleci .\n```\n\n这将创建一个标记为`circleci:mcp-server-circleci`的 Docker 镜像，您可以将其与任何 MCP 客户端一起使用。\n\n运行容器：\n\n```bash\ndocker run --rm -i -e CIRCLECI_TOKEN=your-circleci-token -e CIRCLECI_BASE_URL=https://circleci.com circleci:mcp-server-circleci\n```\n\n## 使用 MCP Inspector 进行开发\n\n在 MCP 服务器上进行迭代最简单的方法是使用 MCP 检查器。您可以在上了解更多关于 MCP 检查器的信息。\n\n1. 启动开发服务器：\n\n ```bash\n pnpm watch # Keep this running in one terminal\n ```\n\n2. 在单独的终端中，启动检查器：\n\n ```bash\n pnpm inspector\n ```\n\n3. 配置环境：\n\n * 将您的`CIRCLECI_TOKEN`添加到检查器 UI 中的环境变量部分\n * 令牌需要对您的 CircleCI 项目的读取权限\n * 您也可以设置 CircleCI 基本 URL。默认为`https//circleci.com`\n\n## 测试\n\n* 运行测试套件：\n\n ```bash\n pnpm test\n ```\n\n* 在开发期间以监视模式运行测试：\n\n ```bash\n pnpm test:watch\n ```\n\n有关更详细的贡献指南，请参阅[CONTRIBUTING.md](CONTRIBUTING.md)","Chinese","zh-CN","githubUser","locale",{"_81":82,"_83":84,"_13":100,"_111":42,"_112":42,"_113":114,"_117":118,"_140":-5,"_16":141,"_142":143,"_144":145,"_33":34,"_156":130,"_157":158,"_162":-5,"_163":164,"_165":-5,"_166":167,"_172":-5,"_152":34,"_173":174,"_178":179,"_131":218,"_219":220},"addedAt","2025-04-06T21:17:47.146146780Z","argumentsJsonSchema",{"_85":86,"_97":98,"_90":99},"properties",{"_87":88,"_92":93},"CIRCLECI_TOKEN",{"_31":89,"_90":91},"Your CircleCI API token with read access to your CircleCI projects","type","string","CIRCLECI_BASE_URL",{"_94":95,"_31":96,"_90":91},"default","https://circleci.com","The base URL for CircleCI API","required",[87],"object",[101,102,103,104,105,106,107,108,109,110],"author:official","category:ci-cd","category:developer-tools","category:app-automation","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":43,"_115":116},"url","https://github.com/circleci-public/mcp-server-circleci","githubRepository",{"_119":120,"_121":122,"_123":124,"_125":126,"_33":34,"_127":128,"_133":134,"_135":136,"_138":139},"defaultBranch","main","fullName","CircleCI-Public/mcp-server-circleci","githubTreeId",109589,"language","TypeScript","owner",{"_129":130,"_131":132},"login","CircleCI-Public","uid","gzl8zIFJlP","recentStargazers",5,"spdxLicense",{"_33":137},"Apache 2.0","stargazers",41,"glamaJson",5060,"inspectable",true,"integrations",[146],{"_147":148,"_31":154,"_131":155},"brand",{"_149":150,"_33":151,"_152":153},"logoSvgPath","M8.963 12c0-1.584 1.284-2.855 2.855-2.855 1.572 0 2.856 1.284 2.856 2.855 0 1.572-1.284 2.856-2.856 2.856-1.57 0-2.855-1.284-2.855-2.856zm2.855-12C6.215 0 1.522 3.84.19 9.025c-.01.036-.01.07-.01.12 0 .313.252.576.575.576H5.59c.23 0 .433-.13.517-.333.997-2.16 3.18-3.672 5.712-3.672 3.466 0 6.286 2.82 6.286 6.287 0 3.47-2.82 6.29-6.29 6.29-2.53 0-4.714-1.5-5.71-3.673-.097-.19-.29-.336-.517-.336H.755c-.312 0-.575.253-.575.576 0 .037.014.072.014.12C1.514 20.16 6.214 24 11.818 24c6.624 0 12-5.375 12-12 0-6.623-5.376-12-12-12z","CircleCI","slug","circleci","Integrates with CircleCI to retrieve build failure logs and identify flaky tests. Supports accessing logs via CircleCI URLs or local project context, and analyzing test execution history to detect unreliable tests in a project's test suite.","eo30mbvc4s","namespace","npmPackage",{"_33":159,"_160":161},"@circleci/mcp-server-circleci","weeklyDownloads",291,"prompts","redditPostForeignId","1jx4mmf","resources","scores",{"_168":169,"_170":169,"_171":169},"license",100,"quality","security","simpleIcon","supportedPlatforms",[175,176,177],"WINDOWS","LINUX","MACOS","tools",[180,206],{"_33":181,"_31":182,"_183":184},"get_build_failure_logs","\n This tool helps debug CircleCI build failures by retrieving failure logs.\n\n Input options (EXACTLY ONE of these two options must be used):\n\n Option 1 - Direct URL (provide ONE of these):\n - projectURL: The URL of the CircleCI project in any of these formats:\n * Project URL: https://app.circleci.com/pipelines/gh/organization/project\n * Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123\n * Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def\n * Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz\n\n Option 2 - Project Detection (ALL of these must be provided together):\n - workspaceRoot: The absolute path to the workspace root\n - gitRemoteURL: The URL of the git remote repository\n - branch: The name of the current branch\n\n IMPORTANT:\n - Never call this tool with incomplete parameters\n - If using Option 1, the URLs MUST be provided by the user - do not attempt to construct or guess URLs\n - If using Option 2, ALL THREE parameters (workspaceRoot, gitRemoteURL, branch) must be provided\n - If neither option can be fully satisfied, ask the user for the missing information before making the tool call\n ","inputSchema",{"_90":99,"_185":186,"_97":187,"_85":189,"_204":205},"$schema","http://json-schema.org/draft-07/schema#",[188],"params",{"_188":190},{"_90":99,"_85":191,"_204":205},{"_192":193,"_195":196,"_198":199,"_201":202},"branch",{"_90":91,"_31":194},"The name of the branch currently checked out in local workspace. This should match local git branch. For example: \"feature/my-branch\", \"bugfix/123\", \"main\", \"master\" etc.","projectURL",{"_90":91,"_31":197},"The URL of the CircleCI project. Can be any of these formats:\n- Project URL with branch: https://app.circleci.com/pipelines/gh/organization/project?branch=feature-branch\n- Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123\n- Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def\n- Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz","gitRemoteURL",{"_90":91,"_31":200},"The URL of the remote git repository. This should be the URL of the repository that you cloned to your local workspace. For example: \"https://github.com/user/my-project.git\"","workspaceRoot",{"_90":91,"_31":203},"The absolute path to the root directory of your project workspace. This should be the top-level folder containing your source code, configuration files, and dependencies. For example: \"/home/user/my-project\" or \"C:\\Users\\user\\my-project\"","additionalProperties",false,{"_33":207,"_31":208,"_183":209},"find_flaky_tests","\n This tool retrieves information about flaky tests in a CircleCI project. \n \n The agent receiving this output MUST analyze the flaky test data and implement appropriate fixes based on the specific issues identified.\n\n Input options (EXACTLY ONE of these two options must be used):\n\n Option 1 - Direct URL (provide ONE of these):\n - projectURL: The URL of the CircleCI project in any of these formats:\n * Project URL: https://app.circleci.com/pipelines/gh/organization/project\n * Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123\n * Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def\n * Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz\n\n Option 2 - Project Detection (ALL of these must be provided together):\n - workspaceRoot: The absolute path to the workspace root\n - gitRemoteURL: The URL of the git remote repository\n\n IMPORTANT:\n - Never call this tool with incomplete parameters\n - If using Option 1, the URLs MUST be provided by the user - do not attempt to construct or guess URLs\n - If using Option 2, BOTH parameters (workspaceRoot, gitRemoteURL) must be provided\n - If neither option can be fully satisfied, ask the user for the missing information before making the tool call\n ",{"_90":99,"_185":186,"_97":210,"_85":211,"_204":205},[188],{"_188":212},{"_90":99,"_85":213,"_204":205},{"_195":214,"_198":216,"_201":217},{"_90":91,"_31":215},"The URL of the CircleCI project. Can be any of these formats:\n- Project URL: https://app.circleci.com/pipelines/gh/organization/project\n- Project URL with branch: https://app.circleci.com/pipelines/gh/organization/project?branch=feature-branch\n- Pipeline URL: https://app.circleci.com/pipelines/gh/organization/project/123\n- Workflow URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def\n- Job URL: https://app.circleci.com/pipelines/gh/organization/project/123/workflows/abc-def/jobs/xyz",{"_90":91,"_31":200},{"_90":91,"_31":203},"65ardm1kp6","updatedAt","2025-05-28T21:00:35.137137163Z","meta",[223,226,228,235,238,240,243,246,249,252,255,257,260,263,265,267,269,271,273],{"_224":225},"title","mcp-server-circleci | Glama",{"_227":42,"_33":31},"content",{"_229":230,"_231":232,"_233":234},"href","https://glama.ai/mcp/servers/@CircleCI-Public/mcp-server-circleci","rel","canonical","tagName","link",{"_227":34,"_236":237},"property","og:title",{"_227":42,"_236":239},"og:description",{"_227":241,"_236":242},"https://glama.ai/logo.png","og:logo",{"_227":244,"_236":245},"https://glama.ai/mcp/servers/@CircleCI-Public/mcp-server-circleci/og-image","og:image",{"_227":247,"_236":248},"630","og:image:height",{"_227":250,"_236":251},"1200","og:image:width",{"_227":253,"_236":254},"website","og:type",{"_227":230,"_236":256},"og:url",{"_227":258,"_236":259},"Glama – MCP Hosting Platform","og:site_name",{"_227":261,"_33":262},"summary_large_image","twitter:card",{"_227":258,"_33":264},"twitter:title",{"_227":42,"_33":266},"twitter:description",{"_227":244,"_33":268},"twitter:image",{"_227":247,"_33":270},"twitter:image:height",{"_227":250,"_33":272},"twitter:image:width",{"_274":275},"script:ld+json",{"_276":277,"_278":279},"@context","http://schema.org","@graph",[280],{"_276":281,"_282":283,"_284":285},"https://schema.org","@type","BreadcrumbList","itemListElement",[286,293,297,301],{"_282":287,"_288":289,"_33":290,"_291":292},"ListItem","item","https://glama.ai/","Glama","position",1,{"_282":287,"_288":294,"_33":295,"_291":296},"https://glama.ai/mcp","MCP",2,{"_282":287,"_288":298,"_33":299,"_291":300},"https://glama.ai/mcp/servers","Servers",3,{"_282":287,"_288":230,"_33":34,"_291":302},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_78":-5,"_29":306,"_221":343,"_377":-5},{"_81":82,"_83":307,"_13":312,"_111":42,"_112":42,"_113":313,"_117":314,"_140":-5,"_16":141,"_142":143,"_144":317,"_33":34,"_156":130,"_157":320,"_162":-5,"_163":164,"_165":-5,"_166":321,"_172":-5,"_152":34,"_173":322,"_178":323,"_131":218,"_219":220},{"_85":308,"_97":311,"_90":99},{"_87":309,"_92":310},{"_31":89,"_90":91},{"_94":95,"_31":96,"_90":91},[87],[101,102,103,104,105,106,107,108,109,110],{"_35":43,"_115":116},{"_119":120,"_121":122,"_123":124,"_125":126,"_33":34,"_127":315,"_133":134,"_135":316,"_138":139},{"_129":130,"_131":132},{"_33":137},[318],{"_147":319,"_31":154,"_131":155},{"_149":150,"_33":151,"_152":153},{"_33":159,"_160":161},{"_168":169,"_170":169,"_171":169},[175,176,177],[324,334],{"_33":181,"_31":182,"_183":325},{"_90":99,"_185":186,"_97":326,"_85":327,"_204":205},[188],{"_188":328},{"_90":99,"_85":329,"_204":205},{"_192":330,"_195":331,"_198":332,"_201":333},{"_90":91,"_31":194},{"_90":91,"_31":197},{"_90":91,"_31":200},{"_90":91,"_31":203},{"_33":207,"_31":208,"_183":335},{"_90":99,"_185":186,"_97":336,"_85":337,"_204":205},[188],{"_188":338},{"_90":99,"_85":339,"_204":205},{"_195":340,"_198":341,"_201":342},{"_90":91,"_31":215},{"_90":91,"_31":200},{"_90":91,"_31":203},[344,346,348,350,352,353,354,355,356,357,358,359,360,361,362,363,364,365,366],{"_224":345},"Reviews | mcp-server-circleci | Glama",{"_227":347,"_33":31},"Read community reviews and feedback for mcp-server-circleci. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_229":349,"_231":232,"_233":234},"https://glama.ai/mcp/servers/@CircleCI-Public/mcp-server-circleci/reviews",{"_227":351,"_236":237},"Reviews | mcp-server-circleci",{"_227":347,"_236":239},{"_227":241,"_236":242},{"_227":244,"_236":245},{"_227":247,"_236":248},{"_227":250,"_236":251},{"_227":253,"_236":254},{"_227":349,"_236":256},{"_227":258,"_236":259},{"_227":261,"_33":262},{"_227":258,"_33":264},{"_227":347,"_33":266},{"_227":244,"_33":268},{"_227":247,"_33":270},{"_227":250,"_33":272},{"_274":367},{"_276":277,"_278":368},[369],{"_276":281,"_282":283,"_284":370},[371,372,373,374,375],{"_282":287,"_288":289,"_33":290,"_291":292},{"_282":287,"_288":294,"_33":295,"_291":296},{"_282":287,"_288":298,"_33":299,"_291":300},{"_282":287,"_288":230,"_33":34,"_291":302},{"_282":287,"_288":349,"_33":376,"_291":134},"Reviews","review","actionData","errors"]

Rate & Review

MCP directory API