Get Biji MCP

🚀 Get筆記 MCP Server

Get筆記 MCP Server 是一個用於集成 Get筆記 API 的服務器，藉助 AI 實現強大的知識庫搜索和召回功能，為用戶提供高效、準確的知識檢索服務。

🚀 快速開始

Get筆記 MCP Server 是一個用於集成 Get筆記 (GetBiji) API 的 Model Context Protocol (MCP) 服務器，可實現 AI 增強的知識庫搜索和檢索功能。

✨ 主要特性

• ✅ 基於 stdio 傳輸的 MCP 服務器框架
• ✅ 支持 Bearer Token 認證的 Get筆記 API 客戶端
• ✅ 速率限制 (2 QPS, 5000 次/天)
• ✅ 完善的錯誤處理和日誌記錄
• ✅ TypeScript 完整類型安全
• ✅ 三個 MCP 工具：
  • knowledge_search：AI 增強知識庫搜索
  • knowledge_recall：原始內容召回
  • get_rate_limit_stats：速率限制統計

📦 安裝指南

選項 1：全局安裝（推薦頻繁使用）

npm install -g mcp-get-biji-server

選項 2：使用 npx（無需安裝）

npx mcp-get-biji-server

選項 3：作為項目依賴安裝

npm install mcp-get-biji-server

📚 詳細文檔

配置

1. 複製環境變量模板：

cp .env.example .env

2. 編輯 .env 文件，添加您的 API 密鑰：

GET_BIJI_API_KEY=your_api_key_here
GET_BIJI_API_BASE_URL=https://open-api.biji.com/getnote/openapi
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RATE_LIMIT_QPS=2
RATE_LIMIT_DAILY=5000

在 Claude Desktop 中使用

編輯 Claude Desktop 配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json)：

使用全局安裝

{
  "mcpServers": {
    "get-biji": {
      "command": "mcp-get-biji-server",
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

使用 npx

{
  "mcpServers": {
    "get-biji": {
      "command": "npx",
      "args": ["-y", "mcp-get-biji-server"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

使用本地安裝

{
  "mcpServers": {
    "get-biji": {
      "command": "node",
      "args": ["/path/to/node_modules/mcp-get-biji-server/build/index.js"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

重啟 Claude Desktop 以激活服務器。

MCP 工具說明

1. knowledge_search

AI 增強搜索，返回經過深度處理的答案。 參數：

• question（必填）：搜索問題
• topic_ids（必填）：知識庫 ID 列表（當前只支持 1 個）
• deep_seek（必填）：啟用深度思考
• refs（可選）：返回引用來源
• history（可選）：對話歷史，用於追問

2. knowledge_recall

快速召回原始內容，不經過 AI 處理。 參數：

• question（必填）：搜索問題
• topic_id（可選）：單個知識庫 ID（優先使用）
• topic_ids（可選）：知識庫 ID 列表
• top_k（可選）：返回前 N 個結果（默認：10）
• intent_rewrite（可選）：啟用意圖重寫
• select_matrix（可選）：啟用結果重選
• history（可選）：對話歷史

注意：topic_id 和 topic_ids 必須提供一個，topic_id 優先。

3. get_rate_limit_stats

獲取當前 API 速率限制使用統計。

開發命令

npm run build        # 編譯TypeScript代碼
npm run watch        # 監聽模式編譯
npm run dev          # 編譯並運行
npm test             # 運行測試
npm start            # 直接運行(需先編譯)

API 限制

• QPS 限制：2 次/秒
• 日限制：5000 次/天

服務器內置智能排隊的速率限制器，自動處理這些限制。

項目結構

.
├── src/                  # 源代碼目錄
│   ├── index.ts         # MCP服務器入口
│   ├── client.ts        # API客戶端
│   ├── config.ts        # 配置管理
│   ├── logger.ts        # 日誌系統
│   ├── rate-limiter.ts  # 速率限制器
│   ├── types.ts         # TypeScript類型定義
│   └── test.ts          # 測試腳本
├── build/               # 編譯輸出目錄
├── .env                 # 環境變量配置
└── package.json         # 項目配置文件

技術棧

• Node.js (ES 模塊)
• TypeScript
• @modelcontextprotocol/sdk
• Axios
• dotenv

🔧 技術細節

API 速率限制

服務器的 API 速率限制為 QPS 2 次/秒，每日 5000 次請求。服務器會自動通過智能排隊機制處理速率限制，以確保請求的有序處理。

項目開發

項目使用 Node.js 和 TypeScript 進行開發，利用 ES 模塊規範。依賴於 @modelcontextprotocol/sdk、Axios 和 dotenv 等工具。開發過程中，可使用 npm run build 編譯 TypeScript 代碼，npm run watch 開啟監聽模式編譯，npm run dev 編譯並運行項目，npm test 運行測試，npm start 直接運行（需先編譯）。

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎貢獻！請提交 issue 或 pull request。

特別感謝 小胰寶 和 小 x 寶社區 的貢獻與付出，用愛心與人工智能為癌症/罕見病患者及其家庭提供支持！