🔮 MCP Codebase Oracle

"Bu kodu kim yazdı, ne yapıyor anlamıyorum" sorusunu tarihe gömüyoruz.

MCP Codebase Oracle, herhangi bir yazılım projesini analiz eden, mimari yapıyı çıkaran ve kod değişikliklerinin etkisini önceden gösteren bir Model Context Protocol (MCP) sunucusudur.

✨ Özellikler

🚀 Kurulum

uv ile (önerilen)

# Projeyi klonla
git clone https://github.com/iamseyhmus7/mcp-codebase-oracle.git
cd mcp-codebase-oracle

# Bağımlılıkları kur
uv sync

# Çalıştır
uv run mcp-codebase-oracle

pip ile

pip install mcp-codebase-oracle

Docker ile

docker build -t mcp-codebase-oracle .
docker run -v /path/to/project:/project:ro mcp-codebase-oracle

⚡ MCP İstemci Konfigürasyonu

Claude Desktop

claude_desktop_config.json dosyasına ekle:

{
  "mcpServers": {
    "codebase-oracle": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/mcp-codebase-oracle",
        "run", "mcp-codebase-oracle"
      ]
    }
  }
}

VS Code (Copilot / Continue)

{
  "mcp.servers": {
    "codebase-oracle": {
      "command": "mcp-codebase-oracle",
      "args": []
    }
  }
}

🔧 Kullanılabilir Tool'lar

Tarama & İndeksleme

• scan_project — Proje tarama ve indeksleme
• rescan_project — Incremental güncelleme
• get_project_summary — Proje özeti

Sorgulama

• find_symbol — Fonksiyon/sınıf/değişken arama
• get_symbol_detail — Sembol detayları
• search_code — Kod içi arama
• get_file_overview — Dosya yapı özeti

Graf Analizi

• get_dependency_graph — Bağımlılık grafı
• get_call_graph — Fonksiyon çağrı grafı
• get_class_hierarchy — Sınıf hiyerarşisi
• find_circular_dependencies — Döngüsel bağımlılık tespiti

Etki Analizi

• analyze_impact — Değişiklik etki analizi
• what_if_delete — Silme senaryosu
• what_if_rename — Yeniden adlandırma senaryosu
• find_dead_code — Kullanılmayan kod tespiti

Mimari

• detect_architecture — Mimari pattern tespiti
• get_module_coupling — Modül bağlılık metrikleri
• detect_code_smells — Kod kokusu tespiti

Açıklama & Görselleştirme

• explain_file — Dosya açıklama
• explain_function — Fonksiyon açıklama
• generate_onboarding_guide — Onboarding rehberi
• generate_architecture_diagram — Mimari diyagram
• generate_dependency_matrix — Bağımlılık matrisi
• generate_hotspot_map — Hotspot haritası

🗣️ Desteklenen Diller

🛠️ Geliştirme

# Dev bağımlılıklarını kur
uv sync --extra dev

# Testleri çalıştır
uv run pytest -v

# Linting
uv run ruff check src/ tests/

# Type checking
uv run mypy src/

# MCP Inspector ile test
uv run mcp dev src/mcp_codebase_oracle/server.py

📄 Lisans

MIT License — Detaylar için LICENSE dosyasına bakın.