İçeriğe geç
ceaksan
PREMIUM developer-tools

Local Semantic Code Search: AI Agent'lar için MCP Sunucusu

AI coding agent'ların arama sorunlarını çözen, Tree-sitter AST chunking ve hybrid search kullanan local semantic code search MCP sunucusunun geliştirilme süreci, mimari kararları ve gerçek dünya sonuçları.

20 Oca 2026
TL;DR

AI coding agent'lar codebase aramasında sistematik hatalar yapıyor: %50 false negative, %54-59 token israfı, %60'a düşen diff doğruluğu. Bu sorunları çözmek için Tree-sitter AST chunking, LanceDB hybrid search ve sentence-transformers kullanan local bir MCP sunucusu geliştirdim. Sonuç: hybrid search ile %30'a kadar doğruluk artışı, 52/52 test.

Üyelik Gerekli

Bu içeriğe erişmek için giriş yapmanız ve Premium aboneliğine sahip olmanız gerekmektedir.

Önemli Noktalar
  • 01 AI agent'ların built-in grep araçlarındaki sorunlar zincirleme bozulmaya yol açar: false negative, token doygunluğu, hallucination
  • 02 Tree-sitter AST chunking ile fonksiyon/sınıf bazında semantic bütünlük korunur, 18+ dil desteği
  • 03 Hybrid search (vector + FTS + RRF) ile %30'a kadar doğruluk artışı, uzun dokümanlarda %62'ye kadar
  • 04 Tamamen local çalışır: API key yok, cloud bağımlılığı yok, sentence-transformers ile local embedding
Sık Sorulan Sorular (FAQ)
+ MCP sunucusu nedir ve neden gerekli?

MCP (Model Context Protocol), AI agent'ların harici araçlarla iletişim kurmasını sağlayan bir protokoldür. Bu MCP sunucusu, agent'ların codebase'de semantic arama yapmasını mümkün kılar. Built-in grep araçlarının false negative oranı %50'ye ulaşırken, hybrid search ile doğruluk %30'a kadar artmaktadır.

+ Neden LanceDB tercih edildi?

LanceDB serverless ve dosya bazlı çalışır, ayrı bir veritabanı sunucusu gerektirmez. FTS (full-text search) desteği sayesinde hybrid search yapılabilir. PostgreSQL+pgvector veya Qdrant gibi alternatifler ek altyapı gerektirir.

+ Tree-sitter AST chunking ne anlama gelir?

Tree-sitter, kaynak kodunu soyut sözdizim ağacına (AST) dönüştüren bir parser'dır. AST-aware chunking, kodu satır bazında değil fonksiyon ve sınıf bazında böler. Bu sayede her chunk semantik olarak anlamlı bir bütün oluşturur ve arama doğruluğu artar.

+ Bu sunucu hangi AI agent'larla çalışır?

MCP protokolünü destekleyen tüm agent'larla çalışır. Claude Code başta olmak üzere, MCP desteği olan diğer coding agent'lar da bu sunucuyu kullanabilir. Kurulum tek komutla yapılır.