codebase-memory-mcp nedir? Kod grafiği, kurulum, ajan ayarlarına yazdıkları ve kaldırma

Ajana "bu fonksiyonu kim çağırıyor" gibi bir soru sorarsın; codebase-memory-mcp projenin kodunu (fonksiyon, sınıf, import, HTTP rotası ve aralarındaki ilişkiler) bilgisayarında kalıcı bir bilgi grafiğine dizinlediği için ajan dosyaları tek tek okumadan yanıt verir. Claude Code, Codex gibi kodlama ajanlarına MCP ile sunulur; MIT lisanslı açık kaynak (geliştirici DeusData), hesap ve API anahtarı gerekmiyor. Kurulum betiği ya da npm ile yapılır ve `install` komutu algıladığı ajanların ayarlarına MCP kaydı, skill, alt ajan ve bazılarında hook yazar. Projenin kendi güvenlik belgesi, programın dosya sistemiyle derinlemesine etkileştiğini söylüyor.

Ne yapar: Projenin kodunu ajan için sorgulanabilir grafiğe dizinler
Tür: MCP sunucusu (yerel program)
Nerede: Claude Code, Codex, Gemini CLI, Cursor, VS Code ve ~45 yüzey
Hesap: Yok; anahtar gerekmez
Ajan ayarına yazar: MCP kaydı, skill, ajan, hook, talimat dosyası
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz (MIT)

codebase-memory-mcp ne işe yarar?

Bir kodlama ajanı büyük bir projeyi anlamak için çok sayıda dosyayı okur; bu zaman ve jeton harcar. Bu program projeyi bir kez dizinler ve yapıyı bir grafik olarak saklar. Ajan sonra "bu fonksiyonu kim çağırıyor", "bu değişiklik neleri etkiler", "mimari nasıl" gibi soruları grafikten sorar. MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır.

SenKodla ilgili soru sorarsın

AsistanClaude Code, Codex, Gemini CLI, Cursor

codebase-memory-mcpBilgisayarında çalışır

Kod grafiğiFonksiyon, sınıf, import, rota ve ilişkileri

Hesap ve anahtar yok; install komutu ajan ayarlarına MCP kaydı, skill ve hook yazar.

Çağrı ve etki sorularını grafikten yanıtlatmakNe alırsın: Arama ve çağrı izi sonuçlarıAyrı kurulum gerekir Mimariyi tarayıcıda gezmekNe alırsın: Tarayıcı arayüzüAyrı kurulum gerekir

Araçlar: depoyu dizinleme, yapısal ve anlamsal arama, çağrı yolu izleme, git farkını etkilenen sembollere eşleme, Cypher benzeri salt okunur grafik sorgusu, kod parçası okuma, mimari özeti, mimari karar kaydı (ADR) yönetimi. Yayınlanmış 0.11.0 sürümünün README'si 15 araç sayıyor; ana dalın README'si 17 araç sayıyor ve henüz yayımlanmamış özellikleri de anlatıyor. İsteğe bağlı yerel bir web arayüzü de var (127.0.0.1:9749).

Kime yarar: büyük ya da eski bir kod tabanında kodlama ajanıyla çalışan geliştiricilere. Küçük bir projede dosyaları okumak zaten yeterli olabilir. README'deki "120 kat daha az jeton" gibi iddialar projenin kendi ölçümü.

codebase-memory-mcp nasıl kurulur?

Önce ne yazdığını bil: install komutu algıladığı ajanların yapılandırmasına dokunur (aşağıda "Neye erişir?"). Komutlar README'den aynen alındı.

1. Paketi kur› npm install -g codebase-memory-mcp

2. Ajanlara kaydet› codebase-memory-mcp install

Ajanını yeniden başlat ve "Index this project" de. npm paketi kurulumda platformuna uygun ikili dosyayı GitHub Releases'ten indirir. Node.js 18+ gerekir.

Kurulum betiği› curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

Bu komut ana daldaki betiği indirip doğrudan çalıştırır. README Windows için "indir, incele, çalıştır" diyor; macOS ve Linux'ta da önce dosyayı indirip içeriğine bakmak daha güvenli.

--skip-config seçeneği yalnız ikili dosyayı kurar, ajan ayarlarına dokunmaz.

1. Betiği indir

› Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

2. İçeriğine bak (notepad install.ps1). 3. Engeli kaldır ve çalıştır:

Çalıştır› Unblock-File .\install.ps1

Sonra› .\install.ps1

Yürütme ilkesi hatası olursa README Set-ExecutionPolicy -Scope Process Bypass ya da PowerShell -ExecutionPolicy Bypass -File .\install.ps1 öneriyor. Defender bir sürümü yanlış pozitif olarak işaretlediyse "Sık sorunlar" bölümüne bak.

pip ile› pip install codebase-memory-mcp

Sonra codebase-memory-mcp install. Elle kurmak istersen Releases sayfasından platformuna uygun arşivi indirip checksums.txt ile SHA-256'sını doğrula. Install komutunu istemiyorsan MCP kaydını elle de yazabilirsin:

~/.claude.json ya da proje .mcp.json› {"mcpServers": {"codebase-memory-mcp": {"command": "/path/to/codebase-memory-mcp", "args": []}}}

Kurulumun ajan ayarlarına ne yazacağını görmek için önce --skip-config ile yalnız ikili dosyayı kur, sonra elle MCP kaydı ekle. Hook'ları gözden geçirmeden açma.

codebase-memory-mcp nasıl kullanılır?

Kurduktan sonra ajanını yeniden başlat, projenin klasöründe aç ve dizinlemesini iste. Büyük depolarda dizinleme istemcide zaman aşımına düşebilir; araç eşzamansız modu destekliyor (async: true ile başlat, status: true ile sorgula).

Dizinle"Index this project."

Çağıranları bul"processPayment fonksiyonunu kimler çağırıyor? Bu fonksiyonu değiştirirsem hangi dosyalar etkilenir?"

Git farkının etkisi"Son commit'ten bu yana yaptığım değişikliklerin etkilediği sembolleri ve riskli olanları listele."

Yerel arayüzü aç (isteğe bağlı)› codebase-memory-mcp daemon start --open --port=9749

Arka planda ortak bir süreç (daemon) çalışır ve git projelerindeki değişiklikleri izler. Durdurmak için codebase-memory-mcp daemon stop.

codebase-memory-mcp hangi ajanlarda çalışır?

Claude CodeVar	Otomatik algılanır; MCP kaydı ~/.claude.json; skill, üç grafik ajanı ve hook'lar yazılır.
Codex CLIVar	config.toml, AGENTS.md işaretçisi, skill ve üç salt-okunur ajan; hook'ları /hooks ile gözden geçirip güvenmen gerekir.
Gemini CLI, Cursor, VS Code (Copilot)Var	Otomatik algılanır; ilgili ayar dosyalarına yazar.
Zed, OpenCode, Windsurf, Kiro, Cline ve diğerleriVar	README toplam 45 istemci yüzeyi sayıyor (39 otomatik algılanan, 6 koşullu).
Claude Desktop, claude.aiNet değil	README'deki istemci listesinde adı geçmiyor; "çalışmaz" demek değildir.

Platformlar: macOS ve Linux (arm64, amd64), Windows (amd64). npm sayfası Windows arm64'ü de sayıyor, README yalnız amd64 diyor.

codebase-memory-mcp neye erişir, ne yazar?

Okur

Dizinlenen projenin kaynak kodu ve git durumu; kurulumda algıladığı ajan yapılandırma dosyaları.

Yazar

Grafik dizinlerini ~/.cache/codebase-memory-mcp altına yazar. install komutu ajanların MCP ayarına, skill, alt ajan, hook ve talimat dosyalarına (AGENTS.md, GEMINI.md gibi) kayıt ekler. Arka planda ortak bir daemon çalışır ve git projelerini izler. manage_adr aracı projenin mimari karar kaydını dizin içinde yazar ya da günceller.

Hook'lar (Claude Code)

README: oturum başlangıcında, alt ajan başlangıcında, Grep/Glob/Bash öncesinde (engellemeyen) ve Read sonrasında kapsam denetimi için hook'lar yazılıyor.

Silme

delete_project aracı bir projenin grafik verisini siler, kaynak kodunu silmez. uninstall ajan kayıtlarını ve ikili dosyayı kaldırır.

Veri: README "100% yerel, telemetri toplamaz; kodun, sorguların, ortam değişkenlerin ve kullanımın makinenden çıkmaz" diyor. Dizinlenen kod, bağlı ajanın kullandığı modele giden sorgu sonuçlarına girebilir; bu o ajanın veri politikasına tabi. Yerel sohbet özelliği isteğe bağlı bir tarayıcı modeli indirir (Hugging Face, varsayılan yaklaşık 567 MB) ve yalnız sen başlatırsan.

README ile projenin SECURITY.md dosyası arka plan sürüm denetimi konusunda çelişiyor. README "arka planda sürüm denetimi yok, hiçbir şey eve haber vermez" diyor. SECURITY.md ise MCP başlatılınca arka planda bir güncelleme denetimi iş parçacığının GitHub'dan en son sürüm bilgisini istediğini anlatıyor (curl, 5 saniye sınırlı, proje verisi göndermiyor). Hangisinin yayınlanan sürümde geçerli olduğunu belgeler netleştirmiyor. SECURITY.md ayrıca programın "kaynak dosyaları okuduğunu, ajan yapılandırma dosyalarına yazdığını ve arka plan süreçleri başlattığını" açıkça söylüyor ve kurmadan önce kaynağı incelemeni öneriyor. GitHub Security Advisories ve OSV taramasında kayıtlı uyarı görünmüyor; bu "güvenli" demek değildir.

codebase-memory-mcp ücretsiz mi?

Evet. MIT lisanslı açık kaynak; plan, hesap ya da API anahtarı yok. Kullandığın kodlama ajanının kendi aboneliği ve jeton maliyeti ayrıdır; dizinleme ve grafik sorguları ise bilgisayarında çalışır.

Yapabilirsin

MIT: kullanmak, değiştirmek, ticari işte kullanmak serbest

Yasak

Kaynaktan derlemek için C/C++ derleyici ve zlib gerekir; arayüzü derlemek için Node.js 22+

Kaynak: README ve LICENSE. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Windows Defender bir sürümü Trojan:Script/Wacatac.B!ml olarak işaretliyor	SECURITY.md bunun tek motorun sezgisel eşleşmesi olduğunu, yanlış pozitif olduğuna inandıklarını yazıyor. checksums.txt, SLSA kanıtı ve VirusTotal bağlantılarıyla kendin doğrula. Bu bir güvenlik garantisi değildir.
Windows'ta betik "yürütme ilkesi" hatası veriyor	`Unblock-File .\install.ps1` ya da `Set-ExecutionPolicy -Scope Process Bypass`.
Büyük depoda dizinleme istemcide zaman aşımına düşüyor	index_repository'yi `async: true` ile başlat, `status: true` ile sorgula. Senkron çağrıda istemci vazgeçerse daemon dizinlemeyi iptal eder.
Yeni sürümden sonra ajan eski sürümle çalışıyor ya da "conflict" hatası	README: tüm aktif süreçler aynı sürüm ve önbellek köküne sahip olmalı; kurulumdan sonra açık ajan oturumlarını yeniden başlat.
Kullanıcıların bildirdiği Windows ve yavaş cihazlarda dizinleme ya da daemon sorunları	Açık issue'lar #2584, #2569, #2606 (kilit hatası, 30 sn istemci zaman aşımı, bazı derleyicilerde çökme). Çözüm yazılı değil; yayınlanmış ikili dosya kullan.

codebase-memory-mcp nasıl kaldırılır?

Önizleme: codebase-memory-mcp uninstall --dry-run neyin kaldırılacağını gösterir.
Kaldır: codebase-memory-mcp uninstall kayıtlı ajan girdilerini, skill, hook ve talimatları ve ikili dosyayı kaldırır. Dizinler varsayılan olarak korunur.
Dizinleri de sil: codebase-memory-mcp uninstall -y --delete-indexes.
Arka plan süreci: codebase-memory-mcp daemon stop.

Kurulum betiği ikili dosyanın yanında kalır; uninstall yalnız yolunu yazdırır, silmez.

Sık sorulan sorular

codebase-memory-mcp nedir?

Projenin kodunu bilgisayarında bir bilgi grafiğine dizinleyen ve Claude Code, Codex gibi kodlama ajanlarına MCP ile sunan MIT lisanslı açık kaynak program. Ajan, çağrı ve etki sorularını dosyaları tek tek okumadan grafikten yanıtlar.

codebase-memory-mcp telemetri toplar mı?

README ve SECURITY.md telemetri olmadığını yazıyor. Ancak iki belge arka plan sürüm denetimi konusunda çelişiyor: README denetim olmadığını, SECURITY.md ise GitHub'dan sürüm bilgisini isteyen bir denetim olduğunu söylüyor. Proje verisi gönderilmediği yazılıyor.

Kodum buluta yükleniyor mu?

README'ye göre dizinleme ve grafik depolama makinende kalır. Ancak sorgu sonuçlarını kullandığın kodlama ajanı ve onun modeli görebilir.

Hangi kodlama ajanlarıyla çalışır?

README 45 istemci yüzeyi sayıyor. Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code ve Zed listede. Listede adı geçmeyen bir istemci için "çalışmaz" denemez, "belgede yok" denir.

Kurulum betiği ne yapıyor, güvenli mi?

İkili dosyayı indirir, SHA-256 ile doğrular ve ajan ayarlarına yazar. README Windows'ta çalıştırmadan önce incelemeyi, SECURITY.md kaynağı incelemeyi öneriyor. Kayıtlı bir güvenlik uyarısı görünmüyor; bu "güvenli" demek değildir.

Nasıl kaldırırım?

codebase-memory-mcp uninstall ajan kayıtlarını ve ikili dosyayı kaldırır; dizinler varsayılan olarak korunur, silmek için --delete-indexes kullanılır.

İlgili rehberler

Cline

21st MCP

ai-memory awwwards-animations

Brave Search MCP

Chrome DevTools MCP

Kaynaklar

Resmî kaynaklarda net olmayanlar: Arka plan sürüm denetimi (README ve SECURITY.md çelişiyor) · "120 kat daha az jeton" iddiası (projenin kendi ölçümü) · Homebrew, Scoop, Winget ve Chocolatey komutları · Windows arm64 desteği · ana dal özelliklerinin yayınlanmış sürümde olup olmadığı · Türkçe bilgisi. Her biri ilgili bölümde yazılı.