Feishu Doc MCP

🚀 飛書文檔 MCP

一個用於訪問飛書開放平臺文檔的 Model Context Protocol (MCP) 服務器。該服務器使 Claude 等 AI 助手能夠直接搜索和閱讀飛書 API 文檔。

🚀 快速開始

本項目提供了便捷的使用方式，你可以根據需求選擇合適的安裝方法，使 AI 助手能夠快速訪問飛書 API 文檔。

✨ 主要特性

零配置，無需 API Key

直接對接飛書官方公開的文檔接口，無需申請任何 Token 或 API Key，開箱即用。

動態同步，永不過時

分類列表從飛書 API 即時獲取，自動適應官方文檔結構變化，無硬編碼維護負擔。當飛書新增或調整 API 分類時，本工具自動同步。

覆蓋完整，4800+ 文檔

支持飛書開放平臺全部文檔體系，包括服務端 API、客戶端 API、開發指南、開發教程等 100+ 個分類，涵蓋即時通訊、日曆、通訊錄、雲文檔、審批、人事等全部能力。

內容智能處理

• 大文件自動提示分段讀取，保護 context window。
• 臨時文件智能命名（可讀前綴 + Hash），避免衝突。

高性能設計

• 啟動時並行加載文檔索引和 URI 映射。
• 內存緩存 4800+ 文檔映射，查詢 O(1) 時間複雜度。
• 支持長期運行，無需反覆初始化。

📦 安裝指南

使用 npx（推薦）

無需安裝，直接使用 npx 運行：

npx feishu-doc-mcp@latest

使用 @latest 確保每次運行時獲取最新版本。

全局安裝

npm install -g feishu-doc-mcp

然後運行：

feishu-doc-mcp

💻 使用示例

在 Claude Desktop 中使用

將以下配置添加到 Claude Desktop 配置文件： MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "feishu-doc": {
      "command": "npx",
      "args": ["feishu-doc-mcp@latest"]
    }
  }
}

如果是全局安裝：

{
  "mcpServers": {
    "feishu-doc": {
      "command": "feishu-doc-mcp"
    }
  }
}

可用工具

search_feishu_doc

按分類搜索飛書 API 文檔，返回該分類下的文檔列表。 參數：

• category: 文檔分類，格式為「一級目錄_二級目錄」（例如：「服務端 API_即時通訊」、「開發指南_開發機器人」）

read_feishu_doc

讀取飛書 API 文檔的詳細內容。內容會保存到臨時文件以便訪問。 參數：

• path: 文檔路徑（從 search_feishu_doc 結果中獲取）

📚 詳細文檔

開發

# 安裝依賴
npm install

# 構建
npm run build

# 開發模式運行
npm run dev

# 啟動服務器
npm start

發佈

本項目使用 GitHub Actions 自動發佈到 npm。發佈新版本：

1. 更新 package.json 中的版本號。
2. 提交更改。
3. 創建並推送 tag：

   git tag v1.0.1
   git push origin v1.0.1
   

4. GitHub Actions 會自動構建併發布到 npm。

環境要求

• Node.js >= 18

更新日誌

v1.0.7

• feat: 按二級標題拆分大文檔，便於分段閱讀。
• feat: 請求示例文件保存到文檔目錄下，更好的文件組織。

v1.0.6

• feat: 清理 Markdown 內容中的 md-* 標籤和多餘空行。
• feat: 提取各語言的 SDK 請求示例並單獨保存。

v1.0.5

• refactor: 移除 turndown 依賴，簡化代碼。

📄 許可證

MIT

作者

ztxtxwd