知识库 MCP 服务
基于 Model Context Protocol（MCP）标准，为 AI Agent 提供企业知识库能力。任何支持 MCP 的客户端（Claude、Cursor、OpenClaw、Hermes 等）均可一键接入：知识入库、语义检索、RAG 问答、Wiki 知识页管理。
接入方式
服务基于 MCP Streamable HTTP 传输，API Key（Bearer）认证。在任意 MCP 客户端中配置：
{
"mcpServers": {
"weknora": {
"url": "<mcp-endpoint>",
"headers": {
"Authorization": "Bearer <your-api-key>"
}
}
}
}传输协议
MCP Streamable HTTP（JSON-RPC + SSE）
认证方式
API Key，请求头 Authorization: Bearer
能力数量
31 个工具，覆盖知识库全生命周期
知识库管理
创建工作区与知识库，管理知识库生命周期
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| create_tenant | 创建工作区（租户） | name*, description*, business* |
| list_tenants | 列出全部工作区 | — |
| create_knowledge_base | 创建知识库（可指定向量/总结模型） | name*, description*, embedding_model_id |
| list_knowledge_bases | 列出当前工作区知识库 | — |
| list_shared_knowledge_bases | 列出跨空间共享的知识库 | — |
| get_knowledge_base | 查看知识库详情 | kb_id* |
| delete_knowledge_base | 删除知识库 | kb_id* |
知识检索
向量 + 关键词混合检索，语义召回知识片段
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| hybrid_search | 在知识库中混合检索（向量+关键词） | kb_id*, query*, match_count, 阈值 |
知识条目
多种方式入库，管理知识条目与分块
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| create_knowledge_from_file | 服务器本地文件入库 | kb_id*, file_path* |
| create_knowledge_from_url | 网页 URL 抓取入库 | kb_id*, url* |
| create_knowledge_from_text | Markdown 文本入库 | kb_id*, title*, content* |
| update_knowledge_from_text | 更新 Markdown 条目 | knowledge_id*, content* |
| list_knowledge | 列出知识条目（可按文件夹过滤） | kb_id*, page, page_size |
| get_knowledge | 查看条目详情 | knowledge_id* |
| delete_knowledge | 删除知识条目 | knowledge_id* |
| list_chunks | 列出条目的分块片段 | knowledge_id*, page |
| delete_chunk | 删除单个分块 | knowledge_id*, chunk_id* |
RAG 问答
检索增强生成问答与会话管理
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| create_session | 创建问答会话（绑定知识库+检索策略） | kb_id*, max_rounds, enable_rewrite |
| get_session | 查看会话详情 | session_id* |
| list_sessions | 列出问答会话 | page, page_size |
| delete_session | 删除会话 | session_id* |
| chat | RAG 问答：检索知识库分块后用大模型总结 | session_id*, query*, web_search_enabled |
| agent_chat | Agent 模式问答：自动调用检索/搜索/SQL 等工具 | session_id*, query*, agent_id* |
Agent 管理
自定义 Agent 的发现与配置查看
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| list_agents | 列出当前工作区的自定义 Agent | page, page_size |
| get_agent | 查看 Agent 完整配置 | agent_id* |
模型配置
知识问答 / 向量 / 重排模型管理
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| create_model | 新增模型配置（KnowledgeQA / Embedding / Rerank） | name*, type*, base_url, api_key |
| list_models | 列出全部模型 | — |
| get_model | 查看模型详情 | model_id* |
Wiki 知识页
结构化知识页面：检索、阅读、目录
| 工具 | 功能 | 关键参数（* 为必填） |
|---|---|---|
| wiki_search | 全文检索 Wiki 页面 | kb_id*, query*, limit |
| wiki_read_page | 阅读 Wiki 页面全文（含入链/出链） | kb_id*, slug* |
| wiki_index_view | 获取 Wiki 结构化目录 | kb_id*, limit |
典型用法
知识入库
直接贴入 Markdown（create_knowledge_from_text），或抓取网页（create_knowledge_from_url），自动完成分块与向量化。
语义检索
hybrid_search 以向量+关键词混合召回，适合"知识库里有关于 X 的内容吗"类查询。
RAG 问答
创建会话（create_session）后调用 chat，基于知识库内容回答；agent_chat 更进一步，由 Agent 自主编排检索与工具调用。
Wiki 知识沉淀
wiki_search / wiki_read_page 检索结构化知识页，适合沉淀"方案对比、踩坑结论"这类复利型知识。