Junê (june-mcp)

june-mcp

अपने एजेंट को एक स्मृति दें। june-mcp आधिकारिक MCP सर्वर है Junê के लिए — यह किसी भी MCP होस्ट (Claude Desktop, Claude Code, और अन्य) को June नॉलेज ग्राफ से जोड़ता है, ताकि आपका एजेंट एक साझा, उद्धृत, और टेनेंट-पृथक मेमोरी के विरुद्ध पूछ, खोज, और याद कर सके।

यह पैकेज एक पतला, शून्य-तर्क कनेक्टर है: सभी पुनर्प्राप्ति, ग्राफ निर्माण, और उत्तर देने का कार्य आपके द्वारा इंगित June एंडपॉइंट पर होता है। यहाँ कोई इंजन कोड नहीं है — इसीलिए यह इतना छोटा है कि इसे एक बैठक में पढ़ा जा सके।

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

इंस्टॉल करें

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

इसे एक June एंडपॉइंट पर इंगित करें

june-mcp किसी भी June सेवा से बात करता है। इसे पाने के तीन तरीके हैं:

1. जुने डेस्कटॉप ऐप (लोकल-फर्स्ट)। Junê ऐप चलाएं और इसके लोकल इंजन से कनेक्ट करें — आपकी फ़ाइलें, ग्राफ, और कुंजियाँ आपकी मशीन पर रहती हैं।
2. आपकी अपनी June सेवा। प्रो/टीम ग्राहक june-local इंजन पैकेज चला रहे हैं, वे JUNE_BASE_URL को अपने स्वयं के सर्वर पर इंगित करते हैं।
3. होस्टेड (टीम)। अपने कंसोल से API कुंजी के साथ अपने होस्टेड June वर्कस्पेस एंडपॉइंट पर इंगित करें।

कॉन्फ़िगर करें

सर्वर फेल-क्लोज़्ड है: यह शुरू होने से इनकार करता है जब तक कि उसे पता न हो कि कहाँ कनेक्ट करना है और किस रूप में, और आपको एक संदेश में सब कुछ बताता है जो गायब है (एक बार में एक त्रुटि नहीं)।

env	आवश्यक	अर्थ
JUNE_BASE_URL	✅	आपका June एंडपॉइंट, जैसे http://localhost:8000
JUNE_CANVAS	✅	जिस कैनवस (वर्कस्पेस) से इस कनेक्शन को बाँधना है — एक नाम (work) या कैनवस आईडी। नाम स्टार्टअप पर आईडी में हल होते हैं; अस्पष्ट नाम फेल-क्लोज़्ड होते हैं
JUNE_CANVAS_CREATE	वैकल्पिक	1 पहले रन पर नामित कैनवस बनाता है यदि वह पहले से मौजूद नहीं है (रीड-ओनली मोड में अस्वीकृत)
JUNE_API_KEY	✅	आपकी June API कुंजी (JUNE_ALLOW_ANON=1 बिना-कुंजी लोकल सेटअप के लिए स्पष्ट रूप से ऑप्ट-आउट करता है)
JUNE_LLM_KEY	वैकल्पिक	अपनी स्वयं की LLM कुंजी लाएँ उद्धृत उत्तरों के लिए — प्रति-अनुरोध हेडर के रूप में अग्रेषित, कभी लॉग नहीं होती, सेवा पर कभी संग्रहीत नहीं होती
JUNE_READONLY	वैकल्पिक	1 सभी लेखन टूल को छुपाता और अस्वीकार करता है (मेमोरी रीड-ओनली हो जाती है)
JUNE_FILES_ROOT	वैकल्पिक	ऑप्ट-इन निर्देशिका जहाँ से एजेंट june_ingest_file के माध्यम से फ़ाइलें अपलोड कर सकते हैं — अनसेट ⇒ वह टूल मौजूद नहीं होता
JUNE_TIMEOUT_READ / JUNE_TIMEOUT_ANSWER	वैकल्पिक	प्रति-क्रिया टाइमआउट (डिफ़ॉल्ट 15 सेकंड / 120 सेकंड)
JUNE_LOG_LEVEL	वैकल्पिक	लॉगिंग डिज़ाइन से केवल stderr पर होती है — stdout MCP वायर है

इसे अपने एजेंट से पहले जाँचें

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

डॉक्टर क्रम में सत्यापित करता है: कॉन्फ़िग → सेवा पहुँच योग्य → कैनवस रिज़ॉल्यूशन (आपका कैनवस नाम → उसकी आईडी, जैसे name "work" → 9147bee6-…) → खोज सीम स्वस्थ → टूल मैनिफेस्ट, और प्रति जाँच PASS/FAIL एक मैप किए गए संकेत के साथ प्रिंट करता है (उदा. एक गायब नाम उन कैनवस की सूची देता है जो मौजूद हैं और JUNE_CANVAS_CREATE=1 की ओर इशारा करता है)। डॉक्टर केवल तभी बाहर निकलता है 0 जब हर जाँच पास हो जाती है (अन्यथा 1); सर्वर स्वयं कॉन्फ़िग त्रुटि पर 2 से बाहर निकलता है, आधे-तार से शुरू नहीं होता। पहले डॉक्टर चलाएँ; यह आपके एजेंट के सर्वर को देखने से पहले हर सामान्य गलत कॉन्फ़िगरेशन को पकड़ लेता है।

इसे Claude में जोड़ें

Claude Desktop — claude_desktop_config.json (सेटिंग्स → डेवलपर) में विलय करें:

{
  "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

होस्ट को पूरी तरह पुनः आरंभ करें (macOS पर Cmd+Q), फिर जाँचें कि सर्वर 10 टूल दिखाता है (11 जब आप june_ingest_file को JUNE_FILES_ROOT के माध्यम से ऑप्ट-इन करते हैं)।

टूल

टूल	आपके एजेंट को क्या मिलता है
june_answer	ग्राफ से एक आधारभूत, उद्धृत उत्तर — अनुमान लगाने के बजाय परहेज़ करता है
june_search	एक क्वेरी के लिए रैंक किए गए साक्ष्य (मल्टी-हॉप का समर्थन करता है)
june_context	टोकन बजट के अंतर्गत एक इकट्ठा संदर्भ पैक
june_neighborhood	एक नोड के चारों ओर ग्राफ
june_subgraph	एक सीमित सबग्राफ निर्यात
june_remember	ग्राफ में एक तथ्य/नोट लिखें (तुरंत पुनर्प्राप्ति योग्य और उद्धरण योग्य हो जाता है)
june_ingest	संरचित नोड/किनारा अंतर्ग्रहण
june_enumerate	एक विधेय से मेल खाने वाला हर नोड — रिकॉल-पूर्ण "सभी X सूचीबद्ध करें" (टॉप-k नहीं)
june_ingest_file	ऑपरेटर-अनुमोदित फ़ोल्डर से एक स्थानीय फ़ाइल अपलोड करें (pdf/docx/xlsx/csv/html/md/छवियाँ/ऑडियो) — केवल तब मौजूद होता है जब आप JUNE_FILES_ROOT सेट करते हैं
june_enrich	प्रो: समृद्ध इंजन के साथ कैनवस की पृष्ठभूमि पुनः-निष्कर्षण (आइडेम्पोटेंट; जॉब + पोल; मुफ्त पर 403)
june_resolve	रखरखाव: प्रतिवर्ती same_as किनारों के माध्यम से डुप्लिकेट संस्थाओं को मर्ज करें (सर्वर-साइड चलता है; strong_only=false प्रो पर शब्दार्थ स्तर अनलॉक करता है)

विवरण एजेंट के लिए लिखे गए हैं (क्या → कब → लौटाता है), और प्रत्येक क्लैम्प किया गया इनपुट दृश्य रूप से एजेंट को वापस नोट किया जाता है, चुपचाप छोटा करने के बजाय।

मुफ्त बनाम प्रो — june-pro टैग

june-mcp सभी के लिए एक ही पैकेज है; कोई अलग "प्रो बिल्ड" नहीं है। प्रो एंडपॉइंट की एक संपत्ति है, कनेक्टर की नहीं: एक प्रो-सक्रिय June से कनेक्ट करें (ऐप में एक प्रो लाइसेंस, होस्टेड वर्कस्पेस पर एक प्रो कुंजी) और वही टूल प्रो-ग्रेड परिणाम ले जाते हैं: हर june_remember और june_ingest_file लेखन स्वचालित रूप से समृद्ध इकाई/किनारा इंजन चलाता है (परिणाम रिपोर्ट करता है कौन सा engine चला), june_resolve शब्दार्थ मिलान तक अपग्रेड होता है, और june_enrich उन यादों को बैकफ़िल करता है जो आपके अपग्रेड से पहले मुफ्त स्तर पर लिखी गई थीं। टर्मिनल दिखाता है कि आप किस दुनिया में हैं: --doctor एक edition पंक्ति प्रिंट करता है और सर्वर का स्टार्टअप बैनर कनेक्शन टैग करता है —

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

टैग सेवा के अपने /v1/whoami से पढ़ा जाता है (वही अधिकार स्थिति जो सर्वर-साइड प्रो रूट्स को गेट करती है), इसलिए यह उससे असहमत नहीं हो सकता जो आपको वास्तव में मिलता है — और यह केवल-प्रदर्शन है: अधिकार सेवा पर लागू होते हैं चाहे कोई भी क्लाइंट कुछ भी प्रिंट करे। /v1/whoami के बिना पुरानी सेवाएँ बस कोई टैग नहीं दिखाती हैं।

सुरक्षा मॉडल

टूल सतह कोई कैनवस/वर्कस्पेस पैरामीटर उजागर नहीं करती — वर्कस्पेस सर्वर-साइड आपके कनेक्शन के संदर्भ से बंधा होता है, फेल-क्लोज़्ड। क्रॉस-टेनेंट रीड एक अनुमति जाँच नहीं है जो फेल-ओपन हो सकती है; यह क्लाइंट से अप्रस्तुत है। JUNE_READONLY=1 रीड-ओनली तैनातियों के लिए दूसरी बाड़ जोड़ता है। आपकी BYO LLM कुंजी प्रत्येक उत्तर अनुरोध पर एक हेडर के रूप में सवार होती है और सेवा द्वारा कभी संग्रहीत या लॉग नहीं होती।

त्रुटियाँ

हर अपस्ट्रीम विफलता एक टाइप किए गए, संपादित त्रुटि पेलोड में मैप होती है (केवल अपवाद प्रकार + HTTP स्थिति से निर्मित — कभी भी प्रतिक्रिया निकायों से नहीं), इसलिए सर्वर एंडपॉइंट द्वारा फेंकी गई किसी भी चीज़ से बच जाता है और आपका एजेंट एक साफ, कार्रवाई योग्य संदेश देखता है।

लाइसेंस

MIT. Junê इंजन स्वयं एक अलग, बंद-स्रोत उत्पाद है — यह कनेक्टर खुला हिस्सा है, डिज़ाइन द्वारा।