MCP Sunucusu

Repomix, Model Context Protocol (MCP)'yi destekler ve AI asistanlarının kod tabanınızla doğrudan etkileşime girmesini sağlar. MCP sunucusu olarak çalıştırıldığında Repomix, AI asistanlarının manuel dosya hazırlamaya gerek kalmadan yerel veya uzak depoları analiz için paketleyebileceği araçlar sunar.

NOTE

Bu, kullanıcı geri bildirimlerine ve gerçek dünya kullanımına göre aktif olarak geliştireceğimiz deneysel bir özelliktir

Repomix'i MCP Sunucusu Olarak Çalıştırma

Repomix'i MCP sunucusu olarak çalıştırmak için --mcp bayrağını kullanın:

bash

repomix --mcp

Bu komut Repomix'i MCP sunucusu modunda başlatır ve Model Context Protocol'ü destekleyen AI asistanları tarafından kullanılabilir hale getirir.

MCP Sunucularını Yapılandırma

Repomix'i Claude gibi AI asistanlarıyla MCP sunucusu olarak kullanmak için MCP ayarlarını yapılandırmanız gerekir:

VS Code için

VS Code'a Repomix MCP sunucusunu şu yöntemlerden biriyle kurabilirsiniz:

Kurulum Rozetini Kullanarak:

Komut Satırını Kullanarak:

bash

code --add-mcp '{"name":"repomix","command":"npx","args":["-y","repomix","--mcp"]}'

VS Code Insiders için:

bash

code-insiders --add-mcp '{"name":"repomix","command":"npx","args":["-y","repomix","--mcp"]}'

Cline (VS Code eklentisi) için

cline_mcp_settings.json dosyasını düzenleyin:

json

{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "repomix",
        "--mcp"
      ]
    }
  }
}

Cursor için

Cursor'da Cursor Settings > MCP > + Add new global MCP server yolunu izleyerek Cline ile benzer bir yapılandırmayla yeni bir MCP sunucusu ekleyin.

Claude Desktop için

claude_desktop_config.json dosyasını Cline yapılandırmasına benzer şekilde düzenleyin.

Claude Code için

Claude Code'da Repomix'i MCP sunucusu olarak yapılandırmak için şu komutu kullanın:

bash

claude mcp add repomix -- npx -y repomix --mcp

Alternatif olarak, daha kolay bir deneyim için resmi Repomix eklentilerini kullanabilirsiniz. Eklentiler doğal dil komutları ve daha basit kurulum sunar. Ayrıntılar için Claude Code Eklentileri belgelerine bakın.

npx yerine Docker Kullanımı

npx yerine Docker kullanarak da Repomix'i MCP sunucusu olarak çalıştırabilirsiniz:

json

{
  "mcpServers": {
    "repomix-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/yamadashy/repomix",
        "--mcp"
      ]
    }
  }
}

Kullanılabilir MCP Araçları

MCP sunucusu olarak çalışırken Repomix şu araçları sunar:

pack_codebase

Bu araç, yerel bir kod dizinini AI analizine uygun birleşik bir XML dosyasına paketler. Kod tabanı yapısını analiz eder, ilgili kod içeriğini çıkarır ve metrikler, dosya ağacı ile biçimlendirilmiş kod içeriği dahil kapsamlı bir rapor oluşturur.

Parametreler:

Parametre	Zorunlu	Varsayılan	Açıklama
`directory`	Evet	—	Paketlenecek dizinin mutlak yolu
`compress`	Hayır	`false`	Uygulama ayrıntılarını kaldırırken temel kod imzalarını ve yapısını çıkarmak için Tree-sitter sıkıştırmasını etkinleştirin. Token kullanımını yaklaşık %70 azaltırken anlam bütünlüğünü korur. `grep_repomix_output` artımlı içerik getirmeye izin verdiğinden genellikle gerekli değildir.
`includePatterns`	Hayır	—	fast-glob desenleri kullanarak eklenecek dosyalar. Virgülle ayrılmış (örn. `"*/.{js,ts}"`, `"src/,docs/"`)
`ignorePatterns`	Hayır	—	fast-glob desenleri kullanarak hariç tutulacak ek dosyalar. Virgülle ayrılmış (örn. `"test/*,.spec.js"`). `.gitignore` ve yerleşik dışlamaları tamamlar.
`topFilesLength`	Hayır	`10`	Metrik özetinde gösterilecek boyuta göre en büyük dosya sayısı
`style`	Hayır	`xml`	Çıktı format stili: `xml`, `markdown`, `json` veya `plain`

Örnek:

json

{
  "directory": "/path/to/your/project",
  "compress": false,
  "includePatterns": "src/**/*.ts,**/*.md",
  "ignorePatterns": "**/*.log,tmp/",
  "topFilesLength": 10
}

pack_remote_repository

Bu araç, bir GitHub deposunu getirir, klonlar ve AI analizine uygun birleşik bir XML dosyasına paketler. Uzak depoyu otomatik olarak klonlar, yapısını analiz eder ve kapsamlı bir rapor oluşturur.

Parametreler:

Parametre	Zorunlu	Varsayılan	Açıklama
`remote`	Evet	—	GitHub deposu URL'si veya `kullanıcı/depo` biçimi (örn. `"yamadashy/repomix"`, `"https://github.com/user/repo"` veya `"https://github.com/user/repo/tree/branch"`)
`compress`	Hayır	`false`	Uygulama ayrıntılarını kaldırırken temel kod imzalarını ve yapısını çıkarmak için Tree-sitter sıkıştırmasını etkinleştirin. Token kullanımını yaklaşık %70 azaltırken anlam bütünlüğünü korur. `grep_repomix_output` artımlı içerik getirmeye izin verdiğinden genellikle gerekli değildir.
`includePatterns`	Hayır	—	fast-glob desenleri kullanarak eklenecek dosyalar. Virgülle ayrılmış (örn. `"*/.{js,ts}"`, `"src/,docs/"`)
`ignorePatterns`	Hayır	—	fast-glob desenleri kullanarak hariç tutulacak ek dosyalar. Virgülle ayrılmış (örn. `"test/*,.spec.js"`). `.gitignore` ve yerleşik dışlamaları tamamlar.
`topFilesLength`	Hayır	`10`	Metrik özetinde gösterilecek boyuta göre en büyük dosya sayısı
`style`	Hayır	`xml`	Çıktı format stili: `xml`, `markdown`, `json` veya `plain`

Örnek:

json

{
  "remote": "yamadashy/repomix",
  "compress": false,
  "includePatterns": "src/**/*.ts,**/*.md",
  "ignorePatterns": "**/*.log,tmp/",
  "topFilesLength": 10
}

read_repomix_output

Bu araç, Repomix tarafından oluşturulan çıktı dosyasının içeriğini okur. Büyük dosyalar için satır aralığı belirterek kısmi okumayı destekler. Bu araç, doğrudan dosya sistemi erişiminin sınırlı olduğu ortamlar için tasarlanmıştır.

Parametreler:

Parametre	Zorunlu	Varsayılan	Açıklama
`outputId`	Evet	—	Okunacak Repomix çıktı dosyasının kimliği
`startLine`	Hayır	Dosya başı	Başlangıç satır numarası (1 tabanlı, dahil)
`endLine`	Hayır	Dosya sonu	Bitiş satır numarası (1 tabanlı, dahil)

Özellikler:

Web tabanlı ortamlar veya korumalı uygulamalar için özel olarak tasarlanmıştır
Daha önce oluşturulan çıktıların içeriğini kimliklerini kullanarak getirir
Dosya sistemi erişimi gerektirmeden paketlenmiş kod tabanına güvenli erişim sağlar
Büyük dosyalar için kısmi okumayı destekler

Örnek:

json

{
  "outputId": "8f7d3b1e2a9c6054",
  "startLine": 100,
  "endLine": 200
}

grep_repomix_output

Bu araç, JavaScript RegExp sözdizimini kullanan grep benzeri işlevsellikle bir Repomix çıktı dosyasında desen arar. Eşleşmelerin çevresinde isteğe bağlı bağlam satırlarıyla birlikte eşleşen satırları döndürür.

Parametreler:

Parametre	Zorunlu	Varsayılan	Açıklama
`outputId`	Evet	—	Aranacak Repomix çıktı dosyasının kimliği
`pattern`	Evet	—	Arama deseni (JavaScript RegExp sözdizimi)
`contextLines`	Hayır	`0`	Her eşleşmeden önce ve sonra gösterilecek bağlam satırı sayısı. `beforeLines`/`afterLines` belirtilmişse geçersiz kılınır.
`beforeLines`	Hayır	—	Her eşleşmeden önce gösterilecek satırlar (`grep -B` gibi). `contextLines`'dan önceliklidir.
`afterLines`	Hayır	—	Her eşleşmeden sonra gösterilecek satırlar (`grep -A` gibi). `contextLines`'dan önceliklidir.
`ignoreCase`	Hayır	`false`	Büyük/küçük harfe duyarsız eşleşme gerçekleştirin

Özellikler:

Güçlü desen eşleştirme için JavaScript RegExp sözdizimini kullanır
Eşleşmeleri daha iyi anlamak için bağlam satırlarını destekler
Önceki/sonraki bağlam satırlarının ayrı kontrolüne olanak tanır
Büyük/küçük harfe duyarlı ve duyarsız arama seçenekleri

Örnek:

json

{
  "outputId": "8f7d3b1e2a9c6054",
  "pattern": "function\\s+\\w+\\(",
  "contextLines": 3,
  "ignoreCase": false
}

file_system_read_file ve file_system_read_directory

Repomix'in MCP sunucusu, AI asistanlarının yerel dosya sistemiyle güvenli bir şekilde etkileşime girmesini sağlayan iki dosya sistemi aracı sunar:

file_system_read_file

Mutlak yollar kullanarak yerel dosya sisteminden dosya içeriğini okur
Hassas bilgiler içeren dosyalara erişimi tespit edip önlemek için yerleşik güvenlik doğrulaması içerir
Secretlint kullanarak güvenlik doğrulaması uygular
Hassas bilgiler içeren dosyalara erişimi engeller (API anahtarları, parolalar, gizli bilgiler)
Dizin geçiş saldırılarını önlemek için mutlak yolları doğrular
Geçersiz yollar veya güvenlik sorunları için açık hata mesajlarıyla biçimlendirilmiş içerik döndürür

file_system_read_directory

Mutlak yol kullanarak bir dizinin içeriğini listeler
Dosya ve alt dizinleri açık göstergelerle gösteren biçimlendirilmiş bir liste döndürür
Hem dosyaları hem dizinleri açık göstergelerle ([FILE] veya [DIR]) gösterir
Uygun hata yönetimiyle güvenli dizin gezintisi sağlar
Yolları doğrular ve mutlak olduklarından emin olur
Proje yapısını keşfetmek ve kod tabanı organizasyonunu anlamak için kullanışlıdır

Her iki araç da güçlü güvenlik önlemleri içerir:

Dizin geçiş saldırılarını önlemek için mutlak yol doğrulaması
Uygun erişim haklarını sağlamak için izin kontrolleri
Hassas bilgi tespiti için Secretlint entegrasyonu
Daha iyi hata ayıklama ve güvenlik farkındalığı için açık hata mesajları

Örnek:

typescript

// Dosya okuma
const fileContent = await tools.file_system_read_file({
  path: '/absolute/path/to/file.txt'
});

// Dizin içeriğini listeleme
const dirContent = await tools.file_system_read_directory({
  path: '/absolute/path/to/directory'
});

Bu araçlar, AI asistanlarının şunları yapması gerektiğinde özellikle kullanışlıdır:

Kod tabanındaki belirli dosyaları analiz etmek
Dizin yapılarında gezinmek
Dosya varlığını ve erişilebilirliğini doğrulamak
Güvenli dosya sistemi işlemlerini sağlamak

Repomix'i MCP Sunucusu Olarak Kullanmanın Avantajları

Repomix'i MCP sunucusu olarak kullanmak birçok avantaj sunar:

Doğrudan Entegrasyon: AI asistanları, manuel dosya hazırlamaya gerek kalmadan kod tabanınızı doğrudan analiz edebilir.
Verimli İş Akışı: Dosyaları manuel olarak oluşturma ve yükleme ihtiyacını ortadan kaldırarak kod analizi sürecini kolaylaştırır.
Tutarlı Çıktı: AI asistanının kod tabanını tutarlı ve optimize edilmiş bir biçimde almasını sağlar.
Gelişmiş Özellikler: Kod sıkıştırma, token sayımı ve güvenlik kontrolleri gibi Repomix'in tüm özelliklerinden yararlanır.

Yapılandırıldıktan sonra AI asistanınız, kod tabanlarını analiz etmek için Repomix'in yeteneklerini doğrudan kullanabilir ve kod analizi iş akışlarını daha verimli hale getirir.

İlgili Kaynaklar

Claude Code Eklentileri - Claude Code için pratik eklenti entegrasyonu
Yapılandırma - Repomix davranışını özelleştirin
Komut Satırı Seçenekleri - Tam CLI referansı
Çıktı Formatları - Mevcut çıktı formatları hakkında bilgi edinin

MCP Sunucusu ​

Repomix'i MCP Sunucusu Olarak Çalıştırma ​

MCP Sunucularını Yapılandırma ​

VS Code için ​

Cline (VS Code eklentisi) için ​

Cursor için ​

Claude Desktop için ​

Claude Code için ​

npx yerine Docker Kullanımı ​

Kullanılabilir MCP Araçları ​

pack_codebase ​

pack_remote_repository ​

read_repomix_output ​

grep_repomix_output ​

file_system_read_file ve file_system_read_directory ​

Repomix'i MCP Sunucusu Olarak Kullanmanın Avantajları ​

İlgili Kaynaklar ​

MCP Sunucusu

Repomix'i MCP Sunucusu Olarak Çalıştırma

MCP Sunucularını Yapılandırma

VS Code için

Cline (VS Code eklentisi) için

Cursor için

Claude Desktop için

Claude Code için

npx yerine Docker Kullanımı

Kullanılabilir MCP Araçları

pack_codebase

pack_remote_repository

read_repomix_output

grep_repomix_output

file_system_read_file ve file_system_read_directory

Repomix'i MCP Sunucusu Olarak Kullanmanın Avantajları

İlgili Kaynaklar