Get Biji Dev By Gemini3pro

🚀 Get 筆記 MCP 服務器

這是一個用於集成 Get 筆記 API 的 Model Context Protocol (MCP) 服務器，提供了從 Get 筆記知識庫中搜索和召回知識的工具，能有效助力知識管理與應用。

🚀 快速開始

本服務器可幫助你從 Get 筆記知識庫中搜索和召回知識。以下是快速上手的步驟：

1. 克隆倉庫
2. 安裝依賴：

   npm install
   

3. 從示例創建 .env 文件：

   cp .env.example .env
   

4. 在 .env 中配置您的 API 密鑰：

   GET_API_KEY=T0TR1HWqw+tL00gVc5PPoXDnGIUIuPw7QCBeb1dMC6afCojR9WpHyuZicEFJjkMg3oZYS0HB/S3vqOj7+0e5FGoVtYuv938zkR8=
   GET_NOTE_TOPIC_ID=RYk1kmRJ
   

✨ 主要特性

• 知識庫搜索：經過 AI 處理的搜索，返回綜合的答案和引用。
• 知識庫召回：相關筆記和文件的原始召回。
• 速率限制：內置保護，限制 QPS < 2 和總請求數 < 5000。
• 重試機制：針對瞬時網絡錯誤 (5xx) 的自動重試。

📦 安裝指南

1. 克隆倉庫：獲取項目代碼。
2. 安裝依賴：

   npm install
   

3. 創建配置文件：

   cp .env.example .env
   

4. 配置 API 密鑰：在 .env 文件中設置 API 密鑰。

   GET_API_KEY=T0TR1HWqw+tL00gVc5PPoXDnGIUIuPw7QCBeb1dMC6afCojR9WpHyuZicEFJjkMg3oZYS0HB/S3vqOj7+0e5FGoVtYuv938zkR8=
   GET_NOTE_TOPIC_ID=RYk1kmRJ
   

💻 使用示例

基礎用法

使用 npx 運行

可以直接使用 npx 運行服務器，無需安裝：

npx get_notebook_mcp_server

本地運行

node index.js

使用 MCP Inspector 測試

使用 MCP Inspector 交互式測試 MCP 服務器：

npx @modelcontextprotocol/inspector node index.js

高級用法

MCP 配置 (Claude Desktop)

方式 1：單個知識庫（簡單配置） 在 claude_desktop_config.json 中添加以下配置：

{
  "mcpServers": {
    "get-notes": {
      "command": "npx",
      "args": ["-y", "get_notebook_mcp_server"],
      "env": {
        "GET_API_KEY": "T0TR1HWqw+tL00gVc5PPoXDnGIUIuPw7QCBeb1dMC6afCojR9WpHyuZicEFJjkMg3oZYS0HB/S3vqOj7+0e5FGoVtYuv938zkR8=",
        "GET_NOTE_TOPIC_ID": "RYk1kmRJ"
      }
    }
  }
}

方式 2：多知識庫（分組配置，推薦） 對於多個共享相同 API 密鑰的知識庫，使用分組配置，系統會自動展開為獨立的知識庫：

{
  "mcpServers": {
    "get-notes-multi": {
      "command": "npx",
      "args": ["-y", "get_notebook_mcp_server"],
      "env": {
        "GET_KNOWLEDGE_BASES": "[{\"id\":\"medical_group\",\"name\":\"醫學知識庫組\",\"config\":{\"api_key\":\"T0TR1HWqw+tL00gVc5PPoXDnGIUIuPw7QCBeb1dMC6afCojR9WpHyuZicEFJjkMg3oZYS0HB/S3vqOj7+0e5FGoVtYuv938zkR8=\",\"topics\":[{\"id\":\"kb_pancreatic_trials\",\"name\":\"腫瘤臨床試驗知識庫\",\"topic_id\":\"RYk1kmRJ\"},{\"id\":\"kb_patient_experience\",\"name\":\"小胰寶病友經驗信息\",\"topic_id\":\"mnyV9OjY\"}]}}]"
      }
    }
  }
}

此配置會自動展開為 kb_pancreatic_trials 和 kb_patient_experience 兩個獨立的知識庫。

方式 3：使用本地配置文件（推薦用於開發） 在項目根目錄創建 knowledge_bases.json 文件：

[
  {
    "id": "demo_group",
    "name": "sam的知識庫",
    "description": "使用同一個 API Key 的知識庫",
    "config": {
      "api_key": "T0TR1HWqw+tL00gVc5PPoXDnGIUIuPw7QCBeb1dMC6afCojR9WpHyuZicEFJjkMg3oZYS0HB/S3vqOj7+0e5FGoVtYuv938zkR8=",
      "api_endpoint": "https://open-api.biji.com/getnote/openapi",
      "topics": [
        {
          "id": "kb_pancreatic_trials",
          "name": "腫瘤臨床試驗知識庫",
          "description": "有關腫瘤臨床試驗的知識庫",
          "topic_id": "RYk1kmRJ"
        },
        {
          "id": "kb_patient_experience",
          "name": "小胰寶病友經驗信息",
          "description": "小胰寶病友經驗信息，包括各種指南和治療經驗",
          "topic_id": "mnyV9OjY"
        }
      ]
    }
  }
]

然後在 Claude Desktop 配置中使用本地文件：

{
  "mcpServers": {
    "get-notes": {
      "command": "npx",
      "args": ["-y", "get_notebook_mcp_server"]
    }
  }
}

Claude 如何使用多知識庫

Claude 會自動選擇合適的知識庫，無需手動選擇，工作流程如下：

1. 用戶提問：例如 "胰腺癌術後多久開始化療？"
2. Claude 自動調用 list_knowledge_bases：查看所有可用的知識庫
3. Claude 智能選擇：根據問題內容，自動選擇最相關的知識庫（如 kb_pancreatic_trials）
4. Claude 調用 search_knowledge：傳入選定的 kb_id 和問題
5. 返回結果：Claude 綜合搜索結果給出答案

用戶也可以明確指定：

• "在腫瘤臨床試驗知識庫中搜索：胰腺癌化療方案"
• "在小胰寶病友經驗中查找：化療副作用處理方法" 這樣 Claude 就會明確使用指定的知識庫。

📚 詳細文檔

工具說明

list_knowledge_bases

列出所有可用的知識庫及其 ID、名稱和描述。 參數：無 返回：知識庫信息數組（不包含敏感的 API 密鑰）

search_knowledge

使用 AI 處理搜索知識庫。 參數：

• kb_id (string, 可選)：知識庫 ID。如果未提供，使用第一個配置的知識庫。
• question (string, 必需)：要提問的問題。
• deep_seek (boolean)：啟用深度思考模式（默認值：false）。
• history (array)：用於上下文的聊天曆史。

recall_knowledge

從知識庫原始召回，不進行 AI 綜合。 參數：

• kb_id (string, 可選)：知識庫 ID。如果未提供，使用第一個配置的知識庫。
• question (string, 必需)：問題或查詢。
• top_k (number)：返回結果數量（默認值：10）。
• intent_rewrite (boolean)：啟用意圖重寫（默認值：false）。

開發

運行測試

npm test

項目結構

• src/api：API 客戶端實現
• src/utils：工具類（速率限制器等）
• tests：單元和集成測試
• index.js：MCP 服務器主入口點

📄 許可證

ISC

❤️ 致謝

本項目由小x寶社區貢獻，這是一個專注於改善癌症/罕見病患者及其家庭整個生命週期醫療信息獲取的 AI 開源公益社區。

關於小x寶社區

我們是一個 AI 開源公益社區，致力於使用 AI 技術構建高質量、高密度的患者知識生態系統，以改善醫療信息壁壘。社區匯聚了開源貢獻者、AI 技術專家、癌症患者、家庭成員、醫療專業人員和公益志願者等多元化群體，共同努力改善患者面臨的信息獲取挑戰。

社區網站：https://info.xiao-x-bao.com.cn

我們的使命：使用 AI 技術打破醫療信息壁壘，為患者構建全面的知識生態系統。

社區名稱由來：我們所有的 AI 助手都以"小x寶"命名，如"小胰寶"、"小粉寶"等，因此社區命名為"小x寶社區"。

社區發展：2024 年，項目捐贈給"天工開物基金會"，該基金會提供資金和指導以促進公益倡議。

進展更新：通過微信公眾號"小胰寶助手"發佈。

社區聯繫方式

詳細社區介紹： 查看介紹

聯繫我們：

• 微信號: qinxiaoqiang2002
• 微信號: hhxdeweixinxin
• 微信號: zhuangbiaowei

我們歡迎所有貢獻者、開發人員、醫療專業人員和志願者加入我們的社區，使用技術改善醫療信息可及性！🌟