Kunkun Docs

将 AI Search 连接到支持 MCP 的客户端（例如 Claude Code、OpenCode）。

Kunkun 在 /mcp/rag 提供 MCP 服务，允许支持 MCP 的客户端（如 Claude Code、OpenCode、Cursor）直接调用本地知识库搜索与问答能力。

工作原理

MCP 服务与本地 API 服务共用 9559 端口与鉴权逻辑，并提供以下工具：

工具	输入	说明
`list_rag_instances`	—	列出当前可访问的 RAG 实例
`rag_status`	`instanceId`	获取知识库状态与元信息
`rag_search`	`instanceId`, `query`, `topK`, `mode`, `pathPrefixes`, `languages`（均可选）	执行搜索
`rag_ask`	`instanceId`, `question`, `topK`, `maxContextChunks`（均可选）	发起基于索引的问答

前置条件

已启用并运行 本地 API 服务
拥有至少 search 与 ask 权限的 API Key
至少存在一个已索引内容的知识库

配置

Claude Code

将以下配置写入 ~/.claude/settings.json：

{
  "mcpServers": {
    "kunkun-rag": {
      "type": "url",
      "url": "http://localhost:9559/mcp/rag",
      "headers": {
        "Authorization": "Bearer kk-xxxx"
      }
    }
  }
}

OpenCode

将以下配置写入 ~/.config/opencode/mcp.json：

{
  "mcpServers": {
    "kunkun-rag": {
      "type": "url",
      "url": "http://localhost:9559/mcp/rag",
      "headers": {
        "Authorization": "Bearer kk-xxxx"
      }
    }
  }
}

请将 kk-xxxx 替换为你真实的 API Key。若还未创建，可在 设置 → API Keys 生成。

其他 MCP 客户端

任何支持 Streamable HTTP 的 MCP 客户端都可以连接到 http://localhost:9559/mcp/rag，并通过 Authorization: Bearer <key> 鉴权。

使用示例

连接成功后，AI 助手会自动调用这些工具，例如：

"在我的文档知识库里找一下权限模型"
→ 调用 rag_search 寻找相关内容

"帮我查一下 record storage 的 API 文档"
→ 调用 rag_ask 返回带引用的综合回答

"列出我的知识库"
→ 调用 list_rag_instances

安全性

MCP 端点复用与 REST API 相同的鉴权与授权：

同一套 API Key 权限生效，只有 search/ask 的密钥不能执行管理操作
端点仅监听回环地址（127.0.0.1）
每个请求都在服务端逐条校验权限，不仅在连接时检查一次

也可以用 REST

如果更喜欢直接 HTTP，可使用 REST 接口。MCP 只是将 MCP 工具调用映射到同一组底层处理器的一层封装。

AI Search MCP