Junê (june-mcp)

june-mcp

Hãy cho tác nhân của bạn một bộ nhớ. june-mcp là máy chủ MCP chính thức cho Junê — nó kết nối bất kỳ máy chủ MCP nào (Claude Desktop, Claude Code và các đối tác) tới đồ thị tri thức June, để tác nhân của bạn có thể hỏi, tìm kiếm và ghi nhớ trên một bộ nhớ chia sẻ, có trích dẫn, được phân chia theo đối tượng thuê.

Gói này là một trình kết nối mỏng, không có logic: tất cả việc truy xuất, lắp ráp đồ thị và trả lời đều xảy ra trên điểm cuối June mà bạn trỏ tới. Không có mã động cơ nào ở đây — đó là lý do nó đủ nhỏ để đọc trong một lần ngồi.

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

Cài đặt

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

Trỏ nó tới một điểm cuối June

june-mcp nói chuyện với bất kỳ dịch vụ June nào. Ba cách để có một:

1. Ứng dụng desktop Junê (ưu tiên cục bộ). Chạy ứng dụng Junê và kết nối tới động cơ cục bộ của nó — các tệp, đồ thị và khóa của bạn vẫn ở trên máy của bạn.
2. Dịch vụ June của riêng bạn. Khách hàng Pro/Team chạy gói động cơ june-local trỏ JUNE_BASE_URL tới máy chủ của họ.
3. Lưu trữ (Team). Trỏ tới điểm cuối không gian làm việc June được lưu trữ của bạn với khóa API từ bảng điều khiển của bạn.

Cấu hình

Máy chủ khóa-cứng: nó từ chối khởi động trừ khi biết nơi để kết nối và là ai, và báo cho bạn mọi thứ còn thiếu trong một thông báo (không phải từng lỗi một).

env	bắt buộc	ý nghĩa
JUNE_BASE_URL	✅	Điểm cuối June của bạn, ví dụ http://localhost:8000
JUNE_CANVAS	✅	Không gian (workspace) để ràng buộc kết nối này — một tên (work) hoặc một id canvas. Tên được phân giải thành id tại lúc khởi động; các tên mơ hồ khóa-cứng
JUNE_CANVAS_CREATE	tùy chọn	1 tạo canvas đã đặt tên khi chạy lần đầu nếu nó chưa tồn tại (từ chối trong chế độ chỉ đọc)
JUNE_API_KEY	✅	Khóa API June của bạn (JUNE_ALLOW_ANON=1 chọn không tham gia một cách tường minh cho các thiết lập cục bộ không khóa)
JUNE_LLM_KEY	tùy chọn	Khóa LLM mang-tự-của-bạn cho các câu trả lời có trích dẫn — được chuyển tiếp theo từng yêu cầu dưới dạng tiêu đề, không bao giờ được ghi lại, không bao giờ được lưu trữ trên dịch vụ
JUNE_READONLY	tùy chọn	1 ẩn và từ chối tất cả các công cụ ghi (bộ nhớ trở thành chỉ đọc)
JUNE_FILES_ROOT	tùy chọn	Các tác nhân thư mục chọn tham gia có thể tải tệp từ qua june_ingest_file — không đặt ⇒ công cụ đó không tồn tại
JUNE_TIMEOUT_READ / JUNE_TIMEOUT_ANSWER	tùy chọn	Thời gian chờ theo từng động từ (mặc định 15 s / 120 s)
JUNE_LOG_LEVEL	tùy chọn	Ghi nhật ký chỉ qua stderr theo thiết kế — stdout là đường dây MCP

Kiểm tra nó trước khi tác nhân của bạn làm

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

Bác sĩ xác minh, theo thứ tự: cấu hình → dịch vụ có thể truy cập → phân giải canvas (tên canvas của bạn → id của nó, ví dụ name "work" → 9147bee6-…) → kết nối tìm kiếm lành mạnh → danh sách công cụ, và in PASS/FAIL cho mỗi kiểm tra với một gợi ý được ánh xạ (ví dụ: một tên thiếu sẽ liệt kê các canvas THỰC SỰ tồn tại và trỏ tới JUNE_CANVAS_CREATE=1). Bác sĩ thoát 0 chỉ khi mọi kiểm tra vượt qua (1 nếu không); máy chủ tự thoát 2 trên một lỗi cấu hình thay vì bắt đầu nửa-sáng. Chạy bác sĩ trước; nó bắt mọi cấu hình sai phổ biến trước khi tác nhân của bạn thấy máy chủ.

Nối nó vào Claude

Claude Desktop — hợp nhất vào claude_desktop_config.json (Cài đặt → Nhà phát triển):

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

Khởi động lại hoàn toàn máy chủ (Cmd+Q trên macOS), sau đó kiểm tra máy chủ hiển thị 10 công cụ (11 khi bạn chọn tham gia june_ingest_file qua JUNE_FILES_ROOT).

Các công cụ

công cụ	những gì tác nhân của bạn nhận được
june_answer	Một câu trả lời có cơ sở, có trích dẫn từ đồ thị — kiêng cữ thay vì đoán
june_search	Bằng chứng được xếp hạng cho một truy vấn (hỗ trợ đa bước nhảy)
june_context	Một gói ngữ cảnh được lắp ráp dưới ngân sách token
june_neighborhood	Đồ thị xung quanh một nút
june_subgraph	Một xuất khẩu đồ thị con có giới hạn
june_remember	Ghi một sự kiện/ghi chú vào đồ thị (trở nên có thể truy xuất + trích dẫn ngay lập tức)
june_ingest	Tiếp nhận nút/cạnh có cấu trúc
june_enumerate	MỌI nút khớp với một vị từ — liệt kê "TẤT CẢ X" hoàn chỉnh thu hồi (không phải top-k)
june_ingest_file	Tải lên một tệp cục bộ (pdf/docx/xlsx/csv/html/md/images/audio) từ thư mục được phép của nhà điều hành — chỉ tồn tại khi bạn đặt JUNE_FILES_ROOT
june_enrich	Pro: trích xuất lại nền của canvas với động cơ phong phú hơn (idempotent; công việc + thăm dò; 403 trên miễn phí)
june_resolve	Bảo trì: hợp nhất các thực thể trùng lặp qua các cạnh same_as có thể đảo ngược (chạy phía máy chủ; strong_only=false mở khóa tầng ngữ nghĩa trên Pro)

Các mô tả được viết cho tác nhân (cái gì → khi nào → trả về), và mọi đầu vào bị kẹp được hiển thị ghi chú lại cho tác nhân thay vì cắt im lặng.

Miễn phí vs Pro — thẻ june-pro

june-mcp là một gói cho mọi người; không có "bản dựng Pro" riêng. Pro là một thuộc tính của điểm cuối, không phải của trình kết nối: kết nối tới một June được kích hoạt Pro (giấy phép Pro trong ứng dụng, khóa Pro trên không gian làm việc được lưu trữ) và các công cụ tương tự mang kết quả cấp Pro: mọi june_remember và june_ingest_file ghi tự động chạy các động cơ thực thể/cạnh phong phú hơn (kết quả báo cáo engine nào đã chạy), june_resolve nâng cấp lên khớp ngữ nghĩa, và june_enrich lấp đầy các bộ nhớ được ghi trên tầng miễn phí trước khi bạn nâng cấp. Thiết bị đầu cuối hiển thị bạn đang ở thế giới nào: --doctor in một dòng edition và biểu ngữ khởi động của máy chủ gắn thẻ cho kết nối —

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

Thẻ được đọc từ /v1/whoami của chính dịch vụ (cùng trạng thái quyền sở hữu điều khiển các tuyến Pro phía máy chủ), vì vậy nó không thể mâu thuẫn với những gì bạn thực sự nhận được — và nó chỉ hiển thị: các quyền được thực thi trên dịch vụ bất kể máy khách in gì. Các dịch vụ cũ hơn không có /v1/whoami chỉ đơn giản là không hiển thị thẻ.

Mô hình bảo mật

Bề mặt công cụ không phơi bày tham số canvas/workspace nào — workspace được ràng buộc phía máy chủ từ ngữ cảnh kết nối của bạn, khóa-cứng. Một đọc chéo-đối tượng thuê không phải là một kiểm tra quyền có thể mở khóa; nó không thể biểu diễn từ máy khách. JUNE_READONLY=1 thêm một hàng rào thứ hai cho các triển khai chỉ đọc. Khóa LLM mang-tự-của-bạn của bạn đi trên mỗi yêu cầu trả lời dưới dạng một tiêu đề và không bao giờ được lưu trữ hoặc ghi lại bởi dịch vụ.

Lỗi

Mọi lỗi thượng nguồn được ánh xạ tới một tải trọng lỗi có kiểu, được biên tập lại (được xây dựng chỉ từ loại ngoại lệ + trạng thái HTTP — không bao giờ từ nội dung phản hồi), vì vậy máy chủ sống sót qua bất cứ điều gì điểm cuối ném ra và tác nhân của bạn thấy một thông báo sạch, có thể hành động.

Giấy phép

MIT. Bản thân động cơ Junê là một sản phẩm riêng biệt, đóng mã nguồn — trình kết nối này là phần mở, theo thiết kế.