Contextator
ENTR
Nasıl çalışırKaynaklarMCP araçlarıBlogDokümanlarKendi sunucunda çalıştır
Kendi sunucunda · MCP · AGPL-3.0

Ajanına
dokümantasyonunu ver.
Verilerini değil.

Contextator; bağlanmış bir klasörü, bir git deposunu, yüklenmiş bir Obsidian kasasını ve bir Notion çalışma alanını proje başına tek bir anlamsal aranabilir MCP endpoint’i hâlinde birleştirir — kendi makinenizde, tek bir Docker konteynerinde.

On dakikada başlaNasıl çalıştığına bak

Hesap yok · API anahtarı yok · Varsayılanda dışarı veri çıkışı yok

http://localhost:3444/mcp/handbook
~/contextator
$ cp .env.example .env
$ docker compose up -d
✓ postgres 16 + pgvector hazır
✓ gömme modeli hazır — 384-d, yerel CPU
✓ :3444 dinleniyor
search_docs("imzalama anahtarını nasıl döndürüyoruz")
runbooks/keys.mdRunbooks › Signing keys › Rotation
0.612
security/policy.mdSecurity › Key material
0.488
Şunlarla çalışırClaude CodeCursorClaude Desktopher MCP istemcisi
Tek URL üzerinde Streamable HTTP + eski SSE
Sorun

Dokümantasyon dağınık. Ajanınız değil.

Bir ürünün bilgisi gerçekten de bir depoya, bir wiki’ye, bir kasaya ve bir dışa aktarmaya yayılmış durumdadır. Mevcut her çözüm önce bir insanın bunları tek yere toplamasını ister — ki bu asla olmaz.

  1. 01

    Prompt’a yapıştır

    Bağlam penceresiyle sınırlı, yapıştırıldığı anda eskimiş ve ekipteki her geliştirici tarafından yeniden yapılıyor.

  2. 02

    Ajan depoda grep yapsın

    Aynı checkout’taki dokümanlar için iyi. Notion’daki el kitabı, başka bir depodaki API referansı, bir mimarın dizüstündeki kasa için işe yaramaz.

  3. 03

    Barındırılan bir RAG servisi kullan

    Erişimi çözer ama iç dokümantasyonu üçüncü bir tarafa gönderir, ekip başına hesap ister ve sorgu başına ücretlendirir. Birçok kurum için konu burada biter.

  4. 04

    Tek seferlik bir MCP sunucusu yaz

    Her ekip aynı chunker’ı, aynı gömme döngüsünü, aynı artımlı indeksleyiciyi yazıyor — sonra da bakımını üstleniyor.

Nasıl çalışır

Dört tür kaynak girer. Tek URL çıkar.

Bir index run her kaynağı senkronlar, sonucu gezer, her dosyayı başlıkları boyunca parçalara böler ve parçaları belgesinin yanına gömer. Sorunuz aynı yolu tersten kat eder.

Kaynaklar
yerel dizingit deposuyükleme / arşivnotion çalışma alanı
Index run
sync · tarama · sha256başlıklarda böl, breadcrumb’ı koruCPU’da, gruplar hâlinde göm
değişmeyen → atlanır
Depolama
Konteyner içinde PostgreSQL 16 + pgvectorHNSW kosinüs indeksi127.0.0.1, dışarı açılmaz
Endpoint/mcp/billing
search_docslist_topicsread_document

Artımlı. Dosyalar hash’lenir. Değişmemiş bir koleksiyonun yeniden indekslenmesi sıfır gömme yapar.

İzole. Her sorgu projeyle sınırlıdır; bir projeye verilen oturum bir başkasında reddedilir.

Gözlenebilir. Her koşu; kipi, sayıları, süresi ve hatasıyla birlikte kaydedilir.

Kaynaklar

Dokümanların zaten durduğu yeri göster.

Bir proje aynı anda istediğiniz kadar kaynak tutabilir. Her biri kendi başına senkronlanır ve kendi başına hata verir — bozulan bir kaynak indeksi asla boşaltmaz.

Yerel dizin

Konteynere bağlanan ve yerinde taranan bir klasör. Hiçbir şey kopyalanmaz, salt okunur bağlanır.

handbook/install.md

Git deposu

HTTPS üzerinden tek dallı, sığ bir checkout. Token’la özel depolar, isterseniz yalnızca bir alt dizin, push webhook ile yeniden indeksleme.

api-repo/reference/auth.md

Yüklemeler ve arşivler

Dosyaları, tüm klasörleri ya da bir .zip, .tar veya .rar dosyasını panoya bırakın. Dizin kaçışı ve sıkıştırma bombası korumalarıyla açılır.

spec-2024/overview.md

Obsidian kasası

Her biçimiyle wikilink’ler, callout’lar ve %%yorumlar%% tek bir parça kesilmeden önce sıradan Markdown’a düzleştirilir.

vault/architecture.md

Notion çalışma alanı

Entegrasyonunuzla paylaşılan her sayfa Markdown’a dönüştürülür ve last_edited_time ile senkron tutulur.

notion/onboarding.md
Bağlama öneki

Her yol, nereden geldiğini söyler

Bir kaynağın adı, katkıda bulunduğu her belgenin ilk segmentidir. Ajana bir cevabın hangi depodan geldiğini söyleyen de, iki kaynağın aynı dosya adını taşıyabilmesini sağlayan da budur.

MCP yüzeyi

Üç araç. Bilerek salt okunur.

Ajan küçük ve kendini tarif eden bir yüzey alır — böylece araç adı vermek yerine soru sorarsınız. Karmaşıklık, bir insanın baktığı yerde, panoda durur.

search_docs(query, limit)

Projenin parçaları üzerinde kosinüs benzerliği araması. Her biri dosya yolu, başlık breadcrumb’ı ve skoruyla sıralanmış alıntılar — projede indekslenmiş bir şey yoksa sonuç yerine dürüst bir mesaj.

  • salt okunur
  • idempotent
  • limit 1–20
list_topics()

Projenin tuttuğu her şey; dizine göre gruplanmış, başlıkları, parça sayıları ve her belgenin geldiği kaynakla birlikte. Ajanın aramadan önce neyin var olduğunu öğrenmek için çağırdığı araç.

  • salt okunur
  • kapalı dünya
read_document(path)

Alıntı yetmediğinde, indekslenmiş tek bir dosyanın tam Markdown’ı. Yalnızca o proje için indekslenmiş yollar sunulur — asla rastgele bir dosya sistemi yolu. 512 KB ile sınırlı.

  • salt okunur
  • yol sınırlı

Bir ajan yazamaz, başka bir projeye erişemez, indekslenmemiş bir dosyayı okuyamaz ve bir index run tetikleyemez. İndeksleme bir operatör eylemi olarak kalır — pano, API ya da webhook.

Neden kendi sunucunda

İşe yarar bir kurulum ne API anahtarı ister ne de dışarı bağlantı.

Varsayılanda yerel

Gömmeler, 384 boyutlu çok dilli bir modelle kendi CPU’nuzda hesaplanır. Model bir kez önbelleğe alındıktan sonra varsayılan kurulum hiçbir dış çağrı yapmaz.

Proje bazında izole

Ayrı belgeler, ayrı gömmeler, ayrı oturumlar. /mcp/billing adresine bağlı bir istemci /mcp/mobile’ı asla göremez.

Artımlı indeksleme

Her dosya ham baytlarının sha256’sını taşır. Yeniden indeksleme yalnızca değişene dokunur; böylece her merge’de çalışan bir push webhook ucuz kalır.

Çok dilli erişim

Türkçe dâhil 50’den fazla dil ve diller arası eşleşme: Türkçe bir soru, cevabı veren İngilizce paragrafı bulur.

Tek konteyner

pgvector’lu PostgreSQL 16 imajın içinde gelir ve yalnızca loopback’i dinler. Kurulacak veritabanı yok, çalıştırılacak migration komutu da yok.

Eski ve yeni istemciler

Streamable HTTP ve eski HTTP+SSE taşıması aynı adreste sunulur. İstemci hangisini konuşuyorsa onu seçer; siz hiçbir şey yapılandırmazsınız.

3
MCP aracı
4
Kaynak türü
384
Vektör boyutu
50+
Dil
1
Çalıştırılacak konteyner
0
Bayt dış veri çıkışı
Hızlı başlangıç

Sıfırdan cevaplanmış bir soruya yaklaşık on dakika.

Compose’lu Docker ve bir Markdown klasörü. Hepsi bu — veritabanı konteynerin içinde gelir ve tek yavaş adım yalnızca bir kez yaşanır.

  1. 01Konteyneri başlatın.
  2. 02Bir proje oluşturup dokümanlarınızı gösterin.
  3. 03Panonun yazdırdığı bağlantı parçasını kopyalayın.
  4. 04Ajanınıza dokümantasyonunuzun cevapladığı bir soru sorun.
Hızlı başlangıcı oku
Sunucudabash
$ git clone https://github.com/Tunedness/Contextator.git contextator
$ cd contextator && cp .env.example .env
$ docker compose up -d
→ pano http://localhost:3444/ adresinde
Projenizdeclaude code
$ claude mcp add --transport http demo-docs \
http://localhost:3444/mcp/demo
✓ demo-docs bağlandı — 3 araç

Cursor ve Claude Desktop parçalarını pano, içi doldurulmuş hâlde yazdırır.

Sınırlar nerede

Yapmadığı şeyler konusunda dürüst.

Contextator tek bir kurulum biçimi için tasarlandı: kendi ağınız, kendi operatörünüz. Dokümantasyon bunu açıkça söylüyor, bu sayfa da söylüyor.

Korunan taraf: root, admin ve member rolleriyle hesaplar; AES-256-GCM ile şifrelenen ve bir daha asla okunamayan kaynak token’ları; herhangi bir şey kuyruğa alınmadan önce ham gövdeye karşı doğrulanan kaynak başına webhook secret’ları; her okumada yol sınırlaması.

  1. Açık bir endpoint açıktır

    Bir projenin MCP adresi, üzerine bir bearer token koyana kadar kimlik doğrulaması istemez. O token’ı elinde tutan, o projede indekslenmiş her şeyi okur — bu bir hesap değil, bir endpoint kimlik bilgisidir.

  2. Yalnızca Markdown, MDX ve düz metin

    PDF yok, Office belgesi yok, görsel yok. Çıkarım kalitesi biçimden biçime fazla değişiyor ve bakım maliyetinin tamamını yutardı.

  3. Projeler arası arama yok

    Projeler baştan sona ve bilerek izoledir. Aynı soruya ait iki bilgi gövdesi, iki proje değil, tek bir projenin iki kaynağı olur.

  4. Prompt injection filtrelenmez

    Contextator belgelerinizi sadakatle döndürür; niyeti temizlemez. İndekslediğiniz külliyatı güvenilir girdi olarak görün, çünkü öyle oluyor.

Lisanslama

Özgür yazılım. Ticari olarak da lisanslanabilir.

Contextator kapatılamaz. Çalışan her kurulum lisans metninin tamamını /license.txt adresinde sunar.

Açık kaynak

GNU AGPL v3 veya sonrası

Çalıştırın, inceleyin, değiştirin, paylaşın. Şirketinizin içinde kullanmanız sizden hiçbir şey istemez. Değiştirdiğiniz sürüme başkaları ağ üzerinden erişiyorsa, o kullanıcılara kaynağını borçlusunuz.

Kaynağı GitHub’da oku
Ticari

Ayrı bir lisans

Politikası AGPL yazılıma izin vermeyen ya da Contextator’ı kapalı bir ürünün içinde dağıtması gereken kurumlar için. Telif hakkı sahibi tarafından verilir.

tunedness.com üzerinden sor

Dokümantasyonunuz zaten yazılmış. Bırakın ajan okusun.

Tek bir docker compose up -d, tek bir proje, tek bir URL — ve ekipteki her ajan tahmin etmeyi bırakır.

On dakikada başlaWiki’ye göz at

AGPL-3.0-or-later · Docker · PostgreSQL 16 + pgvector · Node.js 22

Gezinmek için ok tuşları, açmak için Enter.