Junê (june-mcp)

june-mcp

Ajanınıza bir hafıza verin. june-mcp, Junê için resmî MCP sunucusudur — herhangi bir MCP ana bilgisayarını (Claude Desktop, Claude Code ve benzerleri) bir June bilgi grafiğine bağlar; böylece ajanınız paylaşılan, alıntılanan ve kiracı tarafından izole edilen bir hafızaya karşı sorabilir, arayabilir ve hatırlayabilir.

Bu paket ince, mantık içermeyen bir bağlayıcıdır: tüm alma, grafik oluşturma ve yanıtlama, sizin işaret ettiğiniz June uç noktasında gerçekleşir. Burada hiçbir motor kodu bulunmaz — bu yüzden tek oturuşta okunabilecek kadar küçüktür.

Claude Desktop / Claude Code  ──stdio──▶  june-mcp  ──HTTPS──▶  your June endpoint
                                                                 (graph · retrieval · answers)

Kurulum

pip install june-mcp          # just the connector   (or: pipx install june-mcp)
pip install june-ai           # umbrella: june-mcp + june-bench (the benchmark suite)
pip install "june-bench[mcp]" # the bench, with the connector as an extra

Bir June uç noktasına yönlendirin

june-mcp, herhangi bir June hizmetiyle konuşur. Bir tane edinmenin üç yolu vardır:

1. Junê masaüstü uygulaması (yerel-öncelikli). Junê uygulamasını çalıştırın ve yerel motoruna bağlanın — dosyalarınız, grafiğiniz ve anahtarlarınız makinenizde kalır.
2. Kendi June hizmetiniz. Pro/Team müşterileri, june-local motor paketini çalıştırarak JUNE_BASE_URL'yi kendi sunucularına yönlendirir.
3. Barındırılan (Team). Konsolunuzdaki API anahtarıyla barındırılan June çalışma alanı uç noktanıza yönlendirin.

Yapılandırma

Sunucu varsayılan olarak kapalıdır (fail-closed): nereye bağlanacağını ve kim olarak bağlanacağını bilmedikçe başlamayı reddeder ve eksik olan her şeyi tek bir mesajda söyler (her seferinde tek bir hata değil).

env	gerekli	anlam
JUNE_BASE_URL	✅	June uç noktanız, örn. http://localhost:8000
JUNE_CANVAS	✅	Bu bağlantının bağlanacağı tuval (çalışma alanı) — bir ad (work) veya tuval kimliği. Adlar başlangıçta kimliğe çözümlenir; belirsiz adlar kapalı kalır
JUNE_CANVAS_CREATE	isteğe bağlı	1, adlandırılmış tuvali ilk çalıştırmada yoksa oluşturur (salt-okunur modda reddedilir)
JUNE_API_KEY	✅	June API anahtarınız (JUNE_ALLOW_ANON=1, anahtarsız yerel kurulumlar için açıkça vazgeçer)
JUNE_LLM_KEY	isteğe bağlı	Alıntılanan yanıtlar için kendi LLM anahtarınızı getirin — her istekte bir başlık olarak iletilir, asla günlüğe kaydedilmez, hizmette asla saklanmaz
JUNE_READONLY	isteğe bağlı	1 tüm yazma araçlarını gizler ve reddeder (hafıza salt-okunur olur)
JUNE_FILES_ROOT	isteğe bağlı	Dizin ajanlarının june_ingest_file aracılığıyla dosya yükleyebileceği klasör için tercih — ayarlanmamışsa ⇒ bu araç mevcut değildir
JUNE_TIMEOUT_READ / JUNE_TIMEOUT_ANSWER	isteğe bağlı	Fiil başına zaman aşımları (varsayılanlar 15 sn / 120 sn)
JUNE_LOG_LEVEL	isteğe bağlı	Günlük kaydı tasarım gereği yalnızca stderr'e yapılır — stdout MCP teli (wire) içindir

Ajanınızdan önce kontrol edin

JUNE_BASE_URL=http://localhost:8000 JUNE_API_KEY=... JUNE_CANVAS=work june-mcp --doctor

Doktor (doctor) şu sırayla doğrular: yapılandırma → hizmet erişilebilirliği → tuval çözümlemesi (tuval adınız → kimliği, örn. name "work" → 9147bee6-…) → arama arayüzü sağlığı → araç manifestosu ve her kontrol için eşlenmiş bir ipucuyla PASS/FAIL yazdırır (örn. eksik bir ad, var olan tuvalleri listeler ve JUNE_CANVAS_CREATE=1'ı işaret eder). Doktor yalnızca tüm kontroller geçtiğinde 0 koduyla çıkar (aksi takdirde 1); sunucunun kendisi ise bir yapılandırma hatasında yarı bağlı başlamak yerine 2 koduyla çıkar. Önce doktoru çalıştırın; ajanınız sunucuyu görmeden önce tüm yaygın yanlış yapılandırmaları yakalar.

Claude'a bağlayın

Claude Desktop — claude_desktop_config.json içine birleştirin (Ayarlar → Geliştirici):

{
  "mcpServers": {
    "june": {
      "command": "june-mcp",
      "env": {
        "JUNE_BASE_URL": "http://localhost:8000",
        "JUNE_API_KEY": "your-key",
        "JUNE_CANVAS": "work",
        "JUNE_LLM_KEY": "your-llm-provider-key"
      }
    }
  }
}

Claude Code:

claude mcp add june -e JUNE_BASE_URL=http://localhost:8000 \
  -e JUNE_API_KEY=your-key -e JUNE_CANVAS=work \
  -e JUNE_LLM_KEY=your-llm-provider-key -- june-mcp

Ana bilgisayarı tamamen yeniden başlatın (macOS'ta Cmd+Q), ardından sunucunun 10 araç gösterdiğini kontrol edin (JUNE_FILES_ROOT üzerinden june_ingest_file'i seçtiğinizde 11).

Araçlar

araç	ajanınızın elde ettiği şey
june_answer	Grafikten temellendirilmiş, alıntılanmış bir yanıt — tahmin etmek yerine çekimser kalır
june_search	Bir sorgu için sıralanmış kanıt (çok atlamalı destekler)
june_context	Bir token bütçesi altında derlenmiş bir bağlam paketi
june_neighborhood	Tek bir düğümün etrafındaki grafik
june_subgraph	Sınırlı bir alt grafik dışa aktarımı
june_remember	Grafiğe bir olgu/not yazın (anında alınabilir ve alıntılanabilir olur)
june_ingest	Yapılandırılmış düğüm/kenar alımı
june_enumerate	Bir koşulla eşleşen HER düğüm — "tüm X'i listele" için eksiksiz hatırlama (top-k değil)
june_ingest_file	Operatör onaylı klasörden bir yerel dosya yükleyin (pdf/docx/xlsx/csv/html/md/görseller/ses) — yalnızca JUNE_FILES_ROOT ayarladığınızda mevcuttur
june_enrich	Pro: tuvalin daha zengin motorla arka plan yeniden çıkarımı (idempotent; iş + yoklama; ücretsizde 403)
june_resolve	Bakım: yinelenen varlıkları geri alınabilir same_as kenarlarıyla birleştirin (sunucu tarafında çalışır; strong_only=false, Pro'da anlamsal katmanı açar)

Açıklamalar ajan için yazılmıştır (ne → ne zaman → ne döndürür) ve kısıtlanan her girdi, sessizce kesilmek yerine ajana görünür şekilde geri bildirilir.

Ücretsiz vs Pro — june-pro etiketi

june-mcp, herkes için tek bir pakettir; ayrı bir "pro derlemesi" yoktur. Pro, uç noktanın bir özelliğidir, bağlayıcının değil: Pro etkinleştirilmiş bir June'a bağlanın (uygulamada bir Pro lisansı, barındırılan bir çalışma alanında bir Pro anahtarı) ve aynı araçlar Pro düzeyinde sonuçlar taşır: her june_remember ve june_ingest_file yazımı otomatik olarak daha zengin varlık/kenar motorlarını çalıştırır (sonuç hangi engine'in çalıştığını bildirir), june_resolve anlamsal eşleştirmeye yükseltilir ve june_enrich, yükseltmeden önce ücretsiz katta yazılan hafızaları geriye dönük olarak doldurur. Terminal hangi dünyada olduğunuzu gösterir: --doctor, bir edition satırı yazdırır ve sunucunun başlangıç afişi bağlantıyı etiketler —

june-mcp: connected http://localhost:8000 canvas name "work" → 11d2… [june-pro]

Etiket, hizmetin kendi /v1/whoami alanından okunur (Pro rotalarını sunucu tarafında kapatan aynı yetki durumu), bu nedenle gerçekte aldıklarınızla çelişemez — ve yalnızca görüntüleme amaçlıdır: yetkiler, herhangi bir istemcinin ne yazdırdığından bağımsız olarak hizmette uygulanır. /v1/whoami olmayan eski hizmetler yalnızca etiket göstermez.

Güvenlik modeli

Araç yüzeyi hiçbir tuval/çalışma alanı parametresi göstermez — çalışma alanı, bağlantınızın bağlamından sunucu tarafında bağlanır ve kapalı kalır. Kiracılar arası bir okuma, açık kalabilen bir izin kontrolü değildir; istemciden temsil edilemez. JUNE_READONLY=1, salt-okunur dağıtımlar için ikinci bir çit ekler. Kendi LLM anahtarınız, her yanıt isteğinde bir başlık olarak gider ve hizmet tarafından asla kalıcı hale getirilmez veya günlüğe kaydedilmez.

Hatalar

Her üst akış (upstream) hatası, türü belirlenmiş ve kısaltılmış bir hata yüküne eşlenir (yalnızca özel durum türü + HTTP durumundan oluşturulur — asla yanıt gövdelerinden değil), böylece sunucu, uç noktanın attığı her şeye dayanır ve ajanınız temiz, uygulanabilir bir mesaj görür.

Lisans

MIT. Junê motorunun kendisi ayrı, kapalı kaynak bir üründür — bu bağlayıcı, tasarım gereği açık olan kısımdır.