Hakkında

Contextator, dokümantasyonu yapay zekâ ajanlarının konuşabileceği aranabilir bir endpoint’e çevirir. Bir projeyi bir klasöre, bir git deposuna, bir yüklemeye ya da bir Notion çalışma alanına yöneltirsiniz; o proje, Claude Code, Cursor, Claude Desktop ve diğer bütün MCP istemcilerinin anlamsal olarak arayabileceği kendi Model Context Protocol sunucusu hâline gelir.

Ne yapar

• Proje başına tek URL, tam izolasyon. Her proje kendi belgelerini ve vektör gömmelerini tutar; /mcp/billing adresine bağlı bir istemci /mcp/mobile’ı asla görmez.
• Proje başına birçok kaynak. Bağlanmış bir dizin, bir git deposu (ya da onun tek bir alt dizini), yüklenmiş dosyalar ve arşivler, bir Obsidian kasası ya da bir Notion çalışma alanı — her biri kendi adı altında bağlanarak tek bir aranabilir endpoint’te birleşir.
• Grep değil, anlamsal arama. Belgeler başlık breadcrumb’ları bozulmadan parçalara ayrılır ve pgvector ile PostgreSQL’e gömülür; böylece ajan, anahtar kelimeyi tekrarlayan sayfayı değil, soruyu cevaplayan paragrafı bulur.
• Artımlı indeksleme. Dosyalar hash’lenir; yalnızca değişen yeniden gömülür ve silinen dosyalar indeksten düşer. Bir push webhook her commit’te koşu tetikleyebilir.
• Ajan için üç araç. Sıralı alıntılar için search_docs, belge ağacı için list_topics, indekslenmiş tek bir dosyanın tam Markdown’ı için read_document.

Nasıl çalışır

Bir index run önce her kaynağı senkronlar — bir git dalını çeker, Notion sayfalarını indirir, bağlanmış bir klasörü okur — sonra sonucu gezer, her Markdown, MDX veya metin dosyasını başlıkları boyunca parçalara böler, parçaları gömer ve belgesinin yanına yazar. Bir ajan soru sorduğunda, soru aynı yolla gömülür ve yalnızca o projenin parçaları üzerinde bir kosinüs aramasıyla cevaplanır.

Gömmeler varsayılan olarak, 50’den fazla dili kapsayan çok dilli bir modelle yerel CPU’da üretilir. Gömme sağlayıcısını bilerek barındırılan bir API’ye çevirmediğiniz sürece belgelerinize dair hiçbir şey hiçbir yere gönderilmez.

İlkeler

• Önce kendi sunucunuzda. Tek bir Docker konteyneri hem veritabanını hem uygulamayı tutar. Belgeleriniz kendi altyapınızda kalır.
• Varsayılanda yerel. Gömme modeli indirildikten sonra varsayılan kurulum hiçbir dış çağrı yapmaz.
• Bilerek sıkıcı. Pano; derleme adımı olmayan sade HTML, CSS ve ES modülleridir; sunucu Node.js üzerinde TypeScript’tir.
• Hesaplar ve roller. Pano, kullanıcıları kendi hesaplarıyla oturuma alır. root ve admin her şeyi yönetir; bir member yalnızca eklendiği projeleri görür, okur ya da düzenler.
• Her endpoint’te bir kapı. Bir projenin MCP endpoint’i varsayılanda açıktır; kapatmak istediğinizde proje başına bir bearer token zorunlu kılabilirsiniz. Token’lar tek bir projeye özeldir, bir kez gösterilir ve iptal edilebilir.
• Sınırlar konusunda dürüst. Token bir hesap değil, endpoint için bir kimlik bilgisidir: onu elinde tutan, o projede indekslenmiş her şeyi okur ve açık bırakılmış bir proje, adresine erişebilen herkes tarafından okunabilir.

Neyle yapıldı

TypeScript · Node.js 20+ · Fastify 5 · pgvector’lu PostgreSQL 16 · Drizzle ORM · @modelcontextprotocol/sdk · transformers.js.

Kim geliştiriyor

Contextator, Muhammet Şafak tarafından tasarlanıp geliştirilmekte ve bir Tunedness yapımı olarak yayımlanmaktadır. Yazılım, GNU Affero Genel Kamu Lisansı v3 altında özgür ve açık kaynaktır: herkes kullanabilir, inceleyebilir, değiştirebilir ve çalıştırabilir; insanların ağ üzerinden eriştiği her değiştirilmiş sürüm de kaynağını sunmak zorundadır — Contextator kapatılamaz. Bu şartların uymadığı durumlar için ayrı bir ticari lisans mevcuttur.