Developer Tools TypeScript ★ 86

CircleCI-Public/mcp-server-circleci

CircleCI'deki derlemeler başarısız olduğunda AI Ajanlarını devreye sokarak sorunları otomatik olarak çözmesini sağlayın.

Claude Desktop config.json'a ekle

{
  "mcpServers": {
    "circleci-public-mcp-server-circleci": {
      "command": "node",
      "args": [
        "~/.mcp/mcp-server-circleci/index.js"
      ]
    }
  }
}

Bu MCP sunucusu hakkında

CircleCI MCP Server

License: Apache 2.0 CircleCI npm

Model Context Protocol (MCP), bir yeni, standartlaştırılmış protokoldür ve büyük dil modelleri (LLM'ler) ile harici sistemler arasında bağlamı yönetmeyi sağlar. Bu depoda, CircleCI için bir MCP Server sağlıyoruz.

Cursor, Windsurf, Copilot, Claude veya herhangi bir MCP uyumlu istemciyi kullanarak CircleCI ile doğal dil aracılığıyla etkileşim kurun — IDE'nizi terk etmeden.

Araçlar

Araç Açıklama
analyze_diff Git diff'lerini cursor kurallarına karşı analiz edin ve ihlalleri tespit edin
config_helper CircleCI konfigürasyonunuzu doğrulayın ve rehberlik alın
create_prompt_template AI uygulamaları için yapılandırılmış prompt şablonları oluşturun
download_usage_api_data CircleCI Usage API'sinden kullanım verilerini indirin
find_flaky_tests Test yürütme geçmişini analiz ederek kararsız testleri belirleyin
find_underused_resource_classes Yeterince kullanılmayan işlem kaynağına sahip işleri bulun
get_build_failure_logs CircleCI derlemeleri ile ilgili ayrıntılı hata günlüklerini alın
get_job_test_results CircleCI işlerine ilişkin test meta verilerini ve sonuçlarını alın
get_latest_pipeline_status Bir dal için en son ardışık düzenin durumunu alın
list_artifacts CircleCI işi tarafından üretilen yapıtları listeleyin
list_component_versions CircleCI bileşeninin tüm sürümlerini listeleyin
list_followed_projects Takip ettiğiniz tüm CircleCI projelerini listeleyin
recommend_prompt_template_tests Prompt şablonları için test senaryoları oluşturun
rerun_workflow Bir iş akışını baştan veya başarısız olan işten yeniden çalıştırın
run_evaluation_tests CircleCI ardışık düzeninde değerlendirme testleri çalıştırın
run_pipeline Bir ardışık düzeni çalıştırmak üzere tetikleyin
run_rollback_pipeline Bir proje için geri alma işlemini tetikleyin

Kurulum

Cursor

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

Cursor MCP yapılandırmanıza aşağıdakini ekleyin:

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

CIRCLECI_BASE_URL isteğe bağlıdır — yalnızca şirket içi müşteriler için gereklidir. MAX_MCP_OUTPUT_LENGTH isteğe bağlıdır — MCP yanıtları için maksimum çıktı uzunluğu (varsayılan: 50000).

Yerel MCP Server'da Docker Kullanma

Cursor MCP yapılandırmanıza aşağıdakini ekleyin:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Cursor MCP yapılandırmanıza aşağıdakini ekleyin:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "circleci-token",
      "description": "CircleCI API Token",
      "password": true
    }
  ],
  "servers": {
    "circleci-mcp-server-remote": {
      "url": "http://your-circleci-remote-mcp-server-endpoint:8000/mcp"
    }
  }
}
VS Code

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

Projenizde .vscode/mcp.json dosyasına aşağıdakini ekleyin:

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

💡 Girişler ilk sunucu başlatmasında istenir, ardından VS Code tarafından güvenli şekilde saklanır.

Yerel MCP Server'da Docker Kullanma

Projenizde .vscode/mcp.json dosyasına aşağıdakini ekleyin:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Projenizde .vscode/mcp.json dosyasına aşağıdakini ekleyin:

{
  "servers": {
    "circleci-mcp-server-remote": {
      "type": "sse",
      "url": "http://your-circleci-remote-mcp-server-endpoint:8000/mcp"
    }
  }
}
Claude Desktop

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

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

Yerel MCP Server'da Docker Kullanma

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Bir sarmalayıcı betik oluşturun (ör. circleci-remote-mcp.sh):

#!/bin/bash
export CIRCLECI_TOKEN="your-circleci-token"
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Betiği çalıştırılabilir yapın:

chmod +x circleci-remote-mcp.sh

Ardından claude_desktop_config.json dosyasına aşağıdakini ekleyin:

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

Yapılandırma dosyasını bulmak veya oluşturmak için Claude Desktop ayarlarını açın, sol kenar çubuğunda Developer öğesine tıklayın ve ardından Edit Config öğesine tıklayın. Yapılandırma dosyası şu konumdadır:

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

Daha fazla bilgi için: https://modelcontextprotocol.io/quickstart/user

Claude Code

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

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

Yerel MCP Server'da Docker Kullanma

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

claude mcp add circleci-mcp-server -e CIRCLECI_TOKEN=your-circleci-token -- npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Daha fazla bilgi için: https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp

Windsurf

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

Windsurf mcp_config.json dosyasına aşağıdakini ekleyin:

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

Yerel MCP Server'da Docker Kullanma

Windsurf mcp_config.json dosyasına aşağıdakini ekleyin:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Windsurf mcp_config.json dosyasına aşağıdakini ekleyin:

{
  "mcpServers": {
    "circleci": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://your-circleci-remote-mcp-server-endpoint:8000/mcp",
        "--allow-http"
      ],
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Daha fazla bilgi için: https://docs.windsurf.com/windsurf/mcp

Amazon Q Developer CLI

Ön Koşullar:

Amazon Q Developer'daki MCP istemcisi yapılandırması JSON formatında ve mcp.json adlı bir dosyada saklanır. İki yapılandırma düzeyi desteklenir:

  • Global: ~/.aws/amazonq/mcp.json — tüm çalışma alanları için geçerli
  • Çalışma Alanı: .amazonq/mcp.json — mevcut çalışma alanına özgü

Her iki dosya da mevcutsa, içerikleri birleştirilir. Çakışma durumunda, çalışma alanı yapılandırması öncelik alır.

Yerel MCP Server'da NPX Kullanma

~/.aws/amazonq/mcp.json dosyasını düzenleyin veya aşağıdakini içeren .amazonq/mcp.json dosyasını oluşturun:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Bir sarmalayıcı betik oluşturun (ör. circleci-remote-mcp.sh):

#!/bin/bash
export CIRCLECI_TOKEN="your-circleci-token"
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Betiği çalıştırılabilir yapın ve ekleyin:

chmod +x circleci-remote-mcp.sh
q mcp add --name circleci --command "/full/path/to/circleci-remote-mcp.sh"
Amazon Q Developer in the IDE

Ön Koşullar:

Yerel MCP Server'da NPX Kullanma

~/.aws/amazonq/mcp.json dosyasını düzenleyin veya aşağıdakini içeren .amazonq/mcp.json dosyasını oluşturun:

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

Kendi Kendine Yönetilen Uzak MCP Server Kullanma

Bir sarmalayıcı betik oluşturun (ör. circleci-remote-mcp.sh):

#!/bin/bash
npx mcp-remote http://your-circleci-remote-mcp-server-endpoint:8000/mcp --allow-http

Betiği çalıştırılabilir yapın ve ardından MCP yapılandırması UI aracılığıyla ekleyin:

  1. MCP yapılandırması UI'ya erişin
  2. + sembolünü seçin
  3. Kapsam seçin: global veya local
  4. Bir ad girin (ör. circleci-remote-mcp)
  5. Taşıma protokolünü seçin: stdio
  6. Betiğinizin komut yolunu girin
  7. Kaydet'e tıklayın
Smithery

Smithery aracılığıyla CircleCI MCP Server'ı Claude Desktop için otomatik olarak yüklemek için:

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

Demo

Eylemde Görelim

Örnek: "Dalımda en son başarısız ardışık düzeni bul ve günlükleri al" — daha fazla örnek için wiki bölümüne bakın.

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

Araç Ayrıntıları

analyze_diff

Git diff'lerini cursor kurallarına karşı analiz ederek kural ihlallerini belirler.

Sağlayın:

  • Git diff içeriği (ör. git diff --cached, git diff HEAD)
  • Repository kuralları .cursorrules veya .cursor/rules dosyasından

İhlal raporlarını güven puanları ve açıklamalarıyla birlikte döndürür.

Şunlar için faydalıdır:

  • Gönderim öncesi kod kalitesi kontrolleri
  • Takım kodlama standartlarıyla tutarlılığın sağlanması
  • Kodu incelemeden öncce kural ihlallerinin yakalanması
config_helper

CircleCI yapılandırma görevleriyle yardımcı olur ve rehberlik ve doğrulama sağlar.

  • .circleci/config.yml dosyasını söz dizimi ve anlambilim hataları açısından doğrular
  • Ayrıntılı doğrulama sonuçları ve yapılandırma önerileri sağlar
  • Örnek: "CircleCI yapılandırmamı doğrula"
create_prompt_template

Özellik gereksinimlerine dayalı olarak AI öğretimli uygulamalar için yapılandırılmış prompt şablonları oluşturur.

  • Kullanıcı gereksinimlerini optimize edilmiş prompt şablonlarına dönüştürür
  • Yapılandırılmış bir şablon ve gerekli giriş parametrelerini tanımlayan bir bağlam şeması döndürür
  • Örnek: "Yaşa ve konuya göre uyku zamanı hikayeleri oluşturmak için bir prompt şablonu oluştur"
download_usage_api_data

Belirli bir kuruluş için CircleCI Usage API'sinden kullanım verilerini indirir. Esnek tarih girişini kabul eder (ör. "Mart 2025" veya "geçen ay"). Yalnızca bulut özelliği.

Seçenek 1: Aşağıdakileri sağlayarak yeni bir dışa aktarma işi başlatın:

  • orgId, startDate, endDate (maksimum 32 gün), outputDir

Seçenek 2: Aşağıdakileri sağlayarak mevcut bir dışa aktarma işini kontrol edin/indirin:

  • orgId, jobId, outputDir

Belirtilen zaman dilimi için CircleCI kullanım verilerini içeren bir CSV dosyası döndürür.

[!NOTE] Kullanım verileri, maliyet optimizasyonu analizi için find_underused_resource_classes aracına beslenebilir.

find_flaky_tests

Test yürütme geçmişini analiz ederek CircleCI projenizde kararsız testleri belirler. CircleCI'daki kararsız test algılama özelliğinden yararlanır.

Bu araç üç şekilde kullanılabilir:

  1. Project Slug Kullanma (Önerilir):

    • Önce list_followed_projects kullanarak projelerinizi alın, ardından:
    • Örnek: "my-project için kararsız testleri al"

  2. CircleCI Proje URL'si Kullanma:

  3. Yerel Proje Bağlamı Kullanma:

    • Çalışma alanınızdan çalışır ve çalışma alanı kökü ile git uzak URL'si sağlar
    • Örnek: "Geçerli projemdeki kararsız testleri bul"

Çıktı modları:

  • Metin (varsayılan): Kararsız test ayrıntılarını metin formatında döndürür
  • Dosya (FILE_OUTPUT_DIRECTORY env değişkeni gerekir): Kararsız test ayrıntılarını içeren bir dizin oluşturur
find_underused_resource_classes

Ortalama veya maksimum CPU/

Benzer MCP sunucuları

eyaltoledano/claude-task-master Developer Tools

AI destekli geliştirme için yapay zeka tabanlı görev yönetim sistemi. PRD ayrıştırma, görev genişletme, çoklu provider desteği (Claude, OpenAI, Gemini, Perplexity, xAI) ve optimize edilmiş context kullanımı için seçmeli tool yükleme özelliklerine sahiptir.

eyaltoledano/claude-task-master ★ 27,664
GLips/Figma-Context-MCP Developer Tools

Kodlama ajanlarına Figma verilerine doğrudan erişim sağlayarak tasarım implementasyonunu tek adımda tamamlamalarını sağlar.

GLips/Figma-Context-MCP ★ 15,186
DeusData/codebase-memory-mcp Developer Tools

Yüksek performanslı kod zekası MCP sunucusu. Codebase'leri kalıcı bir knowledge graph'e indeksler — ortalama repo milisaniyeler içinde. 66 dil desteği, sub-ms sorgular, %99 daha az token. Tek statik binary, hiç bağımlılık yok.

DeusData/codebase-memory-mcp ★ 10,848
idosal/git-mcp Developer Tools

gitmcp.io, herhangi bir GitHub repository veya projeye bağlanıp belgelendirme yapabilen genel amaçlı bir remote MCP server'ıdır.

idosal/git-mcp ★ 8,197
mobile-next/mobile-mcp Developer Tools

Android/iOS uygulamaları ve cihazların otomasyon, geliştirme ile app scraping işlemleri için MCP Server. iPhone, Google Pixel, Samsung gibi simülatör, emülatör ve fiziksel cihazları destekler.

mobile-next/mobile-mcp ★ 5,247
21st-dev/magic-mcp Developer Tools

21st.dev'in en iyi tasarım mühendislerinden ilham alarak özel olarak hazırlanmış UI bileşenleri oluşturun.

21st-dev/magic-mcp ★ 5,202
Daha fazla: Developer Tools →