Koma Core MCP

io.github.swnotmetal由 GitHub 帳號 swnotmetal 發布v0.1.1更新於 Oct 24, 2026

Protected RAG storage — agents discover public metadata, content only by access token.

發布方自己的服務:core.blue

已驗證STDIO僅桌面知識與記憶安全與監控

概覽

AI 產生的概覽

本機 MCP 伺服器,暴露 Koma Core 的受保護 RAG 儲存,讓助理搜尋公開文件索引並依存取層級取得內容。

可以做什麼
依選用的分類、標籤與數量上限搜尋公開文件索引,僅回傳顯示名稱、分類、標籤、存取層級與預覽等中繼資料,不回傳內容或權杖。依來源 ID 取得文件全文,前提是傳入的使用者層級不低於該文件的層級。可操作啟動時預置的三份示範文件,分別屬於公開、進階與企業層級。
適用情境
適合試用或示範分級檢索模型:文件探索是公開的,而內容存取受存取層級限制。適合在受保護 RAG 儲存上做代理流程原型,而非正式環境的文件管理。
執行需求
透過 stdio 在本機執行,從 npm 套件 koma-core-mcp 安裝(例如使用 npx),因此需要 Node.js。可選設定 KOMA_MASTER_KEY 環境變數用於權杖衍生;未設定時使用示範金鑰。未宣告需要帳號或身分驗證。
安裝前請注意
README 說明這是記憶體內的參考實作,無持久化且使用示範主金鑰,不適合正式環境。KOMA_MASTER_KEY 金鑰用於權杖衍生,若超出示範用途應使用真實的至少 32 位元組值。存取控制依賴呼叫 retrieve_doc 時傳入的 userTier,層級檢查的可信度取決於呼叫方。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Koma Core MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Koma Core MCP

Expose Koma Core's protected RAG storage as MCP tools for AI agents.

bash
npm install koma-core-mcp

What it demonstrates

Discovery ≠ Authorization. Agents can search the public index, but retrieve private content only with the correct access tier.

ToolWhat it doesAccess
search_docsSearch the public index — returns metadata, never contentPublic
retrieve_docFetch full content by source IDRequires userTier ≥ document tier

Setup

bash
# Optional: set a master key for token derivation (default is a demo key)export KOMA_MASTER_KEY=your-32-byte-minimum-secret

Claude Desktop

json
{  "mcpServers": {    "koma-core": {      "command": "npx",      "args": ["-y", "koma-core-mcp"]    }  }}

Tools

search_docs

  • category (optional) — filter by category
  • tag (optional) — filter by tag
  • limit (optional) — max results

Returns metadata only: displayName, category, tags, accessTier, preview. No content, no token.

retrieve_doc

  • sourceId (required) — the document source ID from search_docs
  • userTier (required) — public | premium | enterprise

Returns full content only if userTier ≥ the document's tier.

Seed Data

Three demo documents are ingested on startup:

sourceIdTier
guide-getting-startedpublic
api-referencepremium
internal-architectureenterprise

Security Boundary

This is an in-memory reference implementation — no persistence, demo master key. For production, implement the DatabaseAdapter interface against a real database and provide a real master key. See koma-core's README for the full security boundary.

來源:packages/koma-core-mcp/README.md,提交 d31b9f6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Core 整合