Skip to content

walkthrough.md

Latest commit

 

History

History
49 lines (40 loc) · 1.85 KB

walkthrough.md

File metadata and controls

49 lines (40 loc) · 1.85 KB

多知识库支持使用指南 (Multi-Knowledge Base Support Walkthrough)

概述

我们更新了 MCP 服务器以支持多个“Get 笔记”知识库。这允许用户配置具有独立 API Key 和 Endpoint 的不同知识库，并使 LLM 能够发现并在它们之间进行搜索。

变更说明

1. 配置方式

  • 新配置文件: 项目根目录下的 knowledge_bases.json。
  • 环境变量支持: GET_KNOWLEDGE_BASES 环境变量支持传入 JSON 字符串配置，这对于 npx 或容器化部署非常有用。
  • 向后兼容性: 现有的 GET_API_KEY 和 GET_NOTE_TOPIC_ID 环境变量仍然有效，系统会自动将其创建一个名为 "Default Knowledge Base (Env)" 的默认知识库。

2. 工具变更

  • [新增] list_knowledge_bases: 列出所有可用的知识库及其 ID 和描述。
  • [更新] search_knowledge: 现在必须传入 kb_id 参数。
  • [更新] recall_knowledge: 现在必须传入 kb_id 参数。

使用指南

配置文件示例 (knowledge_bases.json)

[
  {
    "id": "kb_tech",
    "name": "技术文档库",
    "description": "包含 API 文档和开发指南",
    "config": {
      "api_endpoint": "https://open-api.biji.com/getnote/openapi",
      "api_key": "sk-tech-key...",
      "topic_id": "topic_123"
    }
  }
]

环境变量示例 (用于 npx 等场景)

export GET_KNOWLEDGE_BASES='[{"id":"kb_env","name":"环境变量库","description":"...","config":{"api_endpoint":"...","api_key":"...","topic_id":"..."}}]'

MCP 工具调用流程

  1. 列出知识库: 首先调用 list_knowledge_bases 查看可用列表。
  2. 执行搜索: 调用 search_knowledge，传入 kb_id="kb_tech" 以及您的问题。

验证方法

运行测试以验证配置加载和环境变量支持是否正常：

npm test tests/multi_kb.test.js