Daha İyi Kod İndeksleme için Code-Index MCP Sunucusu Nasıl Kullanılır

Merhaba kodlayıcılar! Yapay zeka kodlama asistanınızı her zamankinden daha akıllı hale getirmeye hazır mısınız? Claude veya Cursor gibi büyük dil modellerinin (LLM'ler) kod tabanınızın derinliklerine inmesini sağlayan, oyunun kurallarını değiştiren bir araç olan Code Index MCP Sunucusu ile tanışın. Hata ayıklama, yeniden düzenleme veya belge oluşturma fark etmeksizin, bu Code Index MCP sunucusu, kodunuz için süper akıllı bir kütüphaneci gibi davranır; onu indeksler, arar ve Model Bağlam Protokolü (MCP) aracılığıyla içgörüler sağlar. Bu konuşma rehberinde, ne işe yaradığını, nasıl kurulacağını ve geliştirme iş akışınızı hızlandırmak için nasıl kullanılacağını size anlatacağız. Hadi kodlamaya başlayalım!

💡

Harika API Belgeleri oluşturan mükemmel bir API Test aracı mı istiyorsunuz?

Geliştirici Ekibinizin maksimum verimlilikle birlikte çalışması için entegre, Hepsi Bir Arada bir platform mu istiyorsunuz?

Apidog tüm taleplerinizi karşılar ve Postman'ı çok daha uygun bir fiyata değiştirir!

düğme

Code Index MCP Sunucusu Nedir?

Code Index MCP Sunucusu, yapay zeka modelleri ile kod tabanınız arasındaki boşluğu kapatmak için tasarlanmış Python tabanlı bir Model Bağlam Protokolü (MCP) sunucusudur. Projenizi tarar, aranabilir bir dizin oluşturur ve LLM'lerin kodunuzu profesyonelce anlamasını, aramasını ve analiz etmesini sağlayan araçları ortaya çıkarır. Bunu, yapay zeka asistanınıza Java'dan JavaScript'e, Python'dan PostgreSQL'e kadar projenizin yapısına X-ışını görüşü kazandırmak gibi düşünebilirsiniz.

Şunlar için mükemmeldir:

Kod İncelemesi: Sorunları tespit edin veya iyileştirmeler önerin.
Yeniden Düzenleme: Daha temiz kod için yapay zeka destekli öneriler alın.
Belgelendirme: Kod tabanınızdan otomatik belge oluşturun.
Hata Ayıklama: Hassas aramalarla hataları bulun.
Mimari Analizi: Bağımlılıkları ve yapıyı anlayın.

Bu açık kaynaklı mücevherin (github.com/johnhuang316/code-index-mcp adresinde mevcuttur) kodlama oyununuzu nasıl geliştirebileceğini keşfedelim.

Code Index MCP'nin Temel Özellikleri

Code Index MCP sunucusu, geliştiriciler için olmazsa olmaz kılan özelliklerle doludur. İşte onu parlatan şeyler:

🔍 Akıllı Arama ve Analiz

Arama Araçlarını Otomatik Algılar: Yıldırım hızında sorgular için sisteminizdeki en iyi arama aracını (ugrep, ripgrep, ag veya grep) seçer.
Güvenlikli Regex: Tam regex aramalarını destekler ancak güvenli performans için ReDoS saldırılarına karşı koruma sağlar.
Bulanık Eşleştirme: Düzenleme mesafeleri veya kelime sınırları kullanarak yakın eşleşmeleri bulur, böylece "authUser" "authenticateUser"ı yakalar.
Derin Dosya Analizi: Herhangi bir dosya için içe aktarmalar, sınıflar, yöntemler ve hatta karmaşıklık metrikleri gibi ayrıntıları çıkarır.

🗂️ Geniş Dil Desteği

Sunucu, tonlarca dil ve araç genelinde 50'den fazla dosya türünü işler, bunlar arasında:

Sistem Dilleri: C, C++, Rust, Go, Zig
Nesne Yönelimli: Java, C#, Kotlin, Swift
Betik Dilleri: Python, JavaScript/TypeScript, Ruby, PHP
Web Geliştirme: React, Vue, HTML, CSS, SCSS
Veritabanları: MySQL, PostgreSQL, SQLite
Yapılandırma Dosyaları: JSON, YAML, Markdown

Bu, onu monorepo'lar veya birden çok teknoloji yığınını karıştıran projeler için ideal kılar.

⚡ Performans Artırıcılar

Akıllı İndeksleme: Daha hızlı taramalar için node_modules gibi gereksiz dosyaları atlar.
Kalıcı Önbellekleme: Neredeyse anında tekrarlanan sorgular için dizinleri depolar.
Tembel Yükleme: Arama araçlarını yalnızca gerektiğinde yükler.
Bellek Verimliliği: Büyük kod tabanlarını zorlanmadan işler.

Code Index MCP Kullanımına Adım Adım Rehber

Ön Koşullar

Dalmadan önce şunlara sahip olduğunuzdan emin olun:

Python 3.10+: python.org adresinden indirin.
uv Aracı: pip install uv aracılığıyla kurun veya işletim sisteminiz için astral.sh/uv adresini takip edin.
VS Code veya Claude Desktop: Yapay zeka entegrasyonu için (code.visualstudio.com veya anthropic.com).
Node.js: MCP Inspector ile hata ayıklama için (nodejs.org).
Git: Depoyu klonlamak için (git-scm.com).

Adım 1: Çoğu Kullanıcı İçin Hızlı Kurulum

Code Index MCP Sunucusu'nu çalıştırmanın en kolay yolu, onu yapay zeka istemcinizle yapılandırmaktır. İşte nasıl yapılacağı:

uv'yi Kurun (zaten kurulu değilse):

Windows PowerShell:

irm https://astral.sh/uv/install.ps1 | iex

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Yapay Zeka İstemcinizi Yapılandırın:

İstemcinizin MCP yapılandırma dosyasını bulun:
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows).

VS Code: .vscode/mcp.json

Cursor: ~/.cursor/mcp.json

Bu yapılandırmayı ekleyin:

{
  "mcpServers": {
    "code-index": {
      "command": "uvx",
      "args": ["code-index-mcp"]
    }
  }
}

Yapay Zeka İstemcinizi Yeniden Başlatın:

Claude Desktop veya VS Code'u kapatıp yeniden açın. uvx komutu, Code Index MCP sunucusunu otomatik olarak kurar ve çalıştırır.

Notwatchdogpip install watchdog

Adım 2: Geliştirme Kurulumu (İleri Düzey Kullanıcılar veya Katkıda Bulunanlar İçin)

Kurcalamak veya katkıda bulunmak mı istiyorsunuz? Sunucuyu manuel olarak kurun:

Depoyu Klonlayın:

Çalıştırın:

git clone https://github.com/johnhuang316/code-index-mcp.git
cd code-index-mcp

Bağımlılıkları Senkronize Edin:

Bağımlılıkları kurmak için uv kullanın:

uv sync

Sunucuyu Yerel Olarak Çalıştırın:

Sunucuyu başlatın:

uv run code_index_mcp

MCP Inspector ile Hata Ayıklama:

Gerekirse Node.js'i kurun, ardından çalıştırın:

npx @modelcontextprotocol/inspector uvx code-index-mcp

Inspector'da bağlantıyı kontrol edin, araçları görüntüleyin ve sorguları test edin.

Adım 3: Mevcut Araçları Anlayın

Code Index MCP sunucusu, MCP arayüzü aracılığıyla araçları üç kategoriye ayırarak sunar:

Proje Yönetimi

set_project_path: İndekslenecek proje klasörünü ayarlayın (örn. /Users/dev/my-react-app).
refresh_index: Kod değişikliklerinden sonra dizini yeniden oluşturun.
get_settings_info: Proje yapılandırmasını ve indeksleme durumunu kontrol edin.

Arama ve Keşif

search_code_advanced: Regex veya bulanık aramalar yapın (örn. "get.*Data" fonksiyonlarını bulun).
find_files: Glob desenleri kullanarak dosyaları bulun (örn. src/components/*.ts).
get_file_summary: Bir dosyanın yapısını, fonksiyonlarını ve karmaşıklığını alın.

Sistem ve Bakım

create_temp_directory: Dizin verileri için depolama alanı kurun.
check_temp_directory: Depolama izinlerini doğrulayın.
clear_settings: Önbelleği ve ayarları sıfırlayın.
refresh_search_tools: Mevcut arama araçlarını yeniden algılayın.

Adım 4: Code Index MCP Sunucusunu Test Edin

Sunucuyu Claude Desktop veya VS Code ile test edelim:

Sunucuyu Başlatın:

Hızlı kurulum kullanıyorsanız, istemcinizi yeniden başlatmak otomatik olarak çalıştırır.
Manuel kurulum için çalıştırın:

uv run code_index_mcp

Bir Projeyi İndeksleyin:

Yapay zeka istemcinizde (örn. Claude veya Cursor) şunu girin:

Proje yolunu /Users/dev/my-react-app olarak ayarla

Sunucu, projeyi indeksler ve hızlı erişim için verileri .indexes/ içine depolar.

Bir Arama Yapın:

Şunu deneyin:

src/components içindeki TypeScript dosyalarını ara

Beklenen yanıt:

Bulunan dosyalar: src/components/Button.tsx, src/components/Header.tsx

Bir Dosyayı Özetleyin:

Şunu girin:

src/api/userService.ts dosyasını özetle

Yanıt şunları içerebilir:

Dosya: userService.ts
- Fonksiyonlar: getUser, updateUser
- İçe aktarmalar: axios, User modeli
- Karmaşıklık: Orta

Bulanık Arama:

Şunu deneyin:

'authUser' ile bulanık eşleşen kimlik doğrulama fonksiyonlarını bul

Yanıt:

Bulundu: src/auth/index.ts içinde authenticateUser

Regex Arama:

Şunu girin:

"get.*Data" ile eşleşen fonksiyon çağrılarını ara

Yanıt:

Bulundu: src/api/userService.ts içinde getUserData, src/utils/form.ts içinde getFormData

Adım 5: Genişletme ve Özelleştirme

Code Index MCP'yi daha da iyi hale getirmek mi istiyorsunuz? İşte bazı fikirler:

Dil Eklentileri Ekleyin: Tree-sitter ayrıştırıcılarını kullanarak niş diller için desteği genişletin.
Aramayı Geliştirin: Bir Voyage AI API anahtarı ile anlamsal arama ekleyin (voyageai.com adresinden bir tane edinin).
İndekslemeyi Otomatikleştirin: Yapıtlar aracılığıyla indeksleri senkronize etmek için GitHub Actions'ı kurun.
Katkıda Bulunun: github.com/johnhuang316/code-index-mcp adresine çekme istekleri gönderin. MIT lisanslıdır ve katkılara açıktır!

Sorun Giderme İpuçları

İndeksleme Çalışmıyor mu? Dosya sistemi izlemesi için watchdog'u (pip install watchdog) kurun.
Sunucu Başlamıyor mu? Python 3.10+ ve uv'nin kurulu olduğundan emin olun. Hatalar için terminali kontrol edin.
Araçlar Bulunamıyor mu? İstemcinizdeki MCP yapılandırmasını doğrulayın ve yeniden başlatın.
Aramalar Yavaş mı? Daha hızlı performans için ugrep veya ripgrep'in kurulu olduğundan emin olun.

Neden Code Index MCP Sunucusunu Kullanmalısınız?

Code Index MCP sunucusu, yapay zeka destekli kodlama için bir geliştiricinin rüyasıdır. LLM'nizi, karmaşık projelerde gezinebilen, tam eşleşmeleri bulabilen ve derin içgörüler sağlayabilen bir kod tabanı uzmanına dönüştürür. Testlerimiz, TypeScript bileşenlerini bulabildiğini, dosyaları özetleyebildiğini ve hatta "get.*Data" gibi regex aramalarını kolayca işleyebildiğini gösterdi. 50'den fazla dil desteği ve akıllı indeksleme ile monorepo'lar veya çok dilli projeler için mükemmeldir. Ayrıca, açık kaynaklıdır ve aktif olarak sürdürülmektedir, böylece ihtiyaçlarınızla birlikte gelişeceğine güvenebilirsiniz.

Sonuç

Artık Code Index MCP Sunucusu'nun gücünü serbest bırakmaya hazırsınız! Kod tabanınızı indekslemekten gelişmiş aramalar yapmaya ve içgörüler oluşturmaya kadar, bu sunucu yapay zeka asistanınızı bir kodlama süperstarı haline getirir. İster bir React uygulamasında hata ayıklıyor olun ister bir Rust monorepo'yu analiz ediyor olun, Code Index MCP size yardımcı olur. Deneyin, projeye katkıda bulunun veya harika kullanım durumlarınızı paylaşın; nasıl kullandığınızı görmek harika olur!

Daha fazla ayrıntı için, github.com/johnhuang316/code-index-mcp adresindeki depoyu inceleyin.

💡

düğme