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, bir Notion çalışma alanına, bir Confluence sitesine, herkese açık bir doküman sitesine, bir S3 bucket’ına, Google Drive’a ya da GitHub issue’ları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 Notion çalışma alanı, bir Confluence sitesi, herkese açık bir doküman sitesi, bir S3 bucket’ı, Google Drive ya da GitHub issue’ları — 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 beş 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, bir andan sonra nelerin değiştiği için whats_new, ve dokümantasyonun cevaplamadığı bir soruyu bakımcılara bildiren, yalnızca kendi tablosuna yazan report_gap. Endpoint ayrıca iki prompt (answer_from_docs, explore_topic) ve indekslenmiş belgeleri contextator:// resource’ları olarak sunar.

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, Markdown olmayan dosyaları Markdown’a çevirir (HTML, Word, CSV ve PDF öyle gelir), her dosyayı 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 hibrit bir aramayla — vektör ve anahtar kelime, sıralarıyla birleştirilerek — cevaplanır.

Gömmeler varsayılan olarak, 100 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ı. Yeni bir projenin MCP endpoint’i kapalıdır: token required varsayılandır ve dağıttığınız bir bearer token ister — tek bir projeye özeldir, bir kez gösterilir ve iptal edilebilir. Account required bu kurulumun bir hesabını ister; hesap OAuth 2.1 ile oturum açar ve her istekte yeniden denetlenir; open ise proje başına, bilerek seçtiğiniz bir ayardır.
• 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 22+ · Fastify 5 · pgvector’lu PostgreSQL 16 · Drizzle ORM · MCP TypeScript SDK 2.x (@modelcontextprotocol/server) · 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.

Tunedness hakkında

Tunedness, Centvix çatısı altında faaliyet gösteren uygulamalı bir yapay zekâ araştırma ve mühendislik laboratuvarıdır. Öncü modelleri, ekiplerin canlı ortamda işletebileceği sistemlere dönüştürür. Tunedness çatısı altındaki ürün ve projeler aynı araştırma birikimi üzerine, Centvix’in ortak standartları ve bunların üzerine eklenen Tunedness standartlarıyla geliştirilir. Her biri, güvenilmeden önce ölçülecek ve yayına çıktıktan sonra da sürdürülebilir kalacak şekilde tasarlanır.

tunedness.com

Kurucu hakkında

Muhammet Şafak, Centvix’in kurucusu; 2008’den bu yana yazılım geliştiren bir yazılım mühendisi, sistem mimarı ve mühendislik araştırmacısıdır. Bugün yüksek trafikli dağıtık sistemlerin mimarisi, ölçeklenebilirliği ve güvenilirliği üzerinde çalışıyor. Sistem davranışını tekrarlanabilir ölçümlerle inceleyen bağımsız araştırmalar yayımlıyor ve teknolojiyi dile değil probleme göre seçiyor. Kalan zamanında Centvix çatısı altında açık kaynak araçlar ve altyapı yazılımları geliştiriyor.

muhammetsafak.com