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 集成