Jiang Feishu MCP

🚀 飛書文檔 MCP

飛書文檔 MCP 是一個基於 Model Context Protocol (MCP) 的服務，它能讓你在 Cursor 等 AI 客戶端中直接訪問飛書文檔空間和文檔列表，為使用 AI 處理飛書文檔提供了便利。

🚀 快速開始

安裝與運行

從源碼安裝

# 克隆項目
git clone https://github.com/yourusername/jiang-feishu-mcp.git
cd jiang-feishu-mcp

# 安裝依賴
pnpm install

# 啟動服務
pnpm start

服務器將在本地 7777 端口啟動。

配置

在使用前，您需要創建一個 .env 文件配置飛書應用憑證：

# 複製示例配置文件
cp .env.example .env

然後編輯 .env 文件，填入您的飛書應用憑證：

FEISHU_APP_ID=your_app_id_here
FEISHU_APP_SECRET=your_app_secret_here

# 可選：設置端口號 (默認為7777)
PORT=7777

# 可選：設置文檔保存路徑 (默認為 ./docs)
DOCS_SAVE_PATH=./docs

獲取飛書應用憑證的步驟：

1. 訪問 飛書開放平臺 並登錄
2. 創建一個企業自建應用
3. 在應用詳情頁獲取 App ID 和 App Secret
4. 確保開啟了雲文檔相關權限（文檔、表格、雲空間讀取權限）

在 Cursor 中使用

1. 啟動服務器：pnpm start
2. 打開 Cursor 的設置頁面
3. 找到 "Model Context Protocol" 設置
4. 添加新的 MCP Server，URL 填入：http://localhost:7777/mcp
5. 保存設置

現在，您可以在 Cursor 中使用以下工具：

• list-spaces：列出所有文檔空間
• list-documents：列出所有或指定空間的文檔

✨ 主要特性

• 支持獲取飛書全部雲文檔空間列表
• 支持獲取指定空間的文檔列表
• 通過 MCP 協議與 AI 客戶端無縫連接

📚 詳細文檔

什麼是 MCP

MCP (Model Context Protocol) 是一個將自定義服務與各種 LLM 客戶端（如 Claude、Cursor）無縫連接的協議。它允許 AI 直接調用和使用我們的服務功能。

• MCP 客戶端：AI 應用程序（如 Claude Desktop 或 Cursor），負責發起請求並與服務器通信
• MCP 服務器：本項目，暴露飛書文檔功能，通過標準化協議與客戶端交互

💻 使用示例

基礎用法

在 Cursor 中，您可以這樣使用 MCP 工具：

請列出我所有的飛書文檔空間

請列出空間 ID 為"XYZ123"中的所有文檔

🔧 技術細節

該項目使用了以下技術：

• Node.js 和 TypeScript：開發環境
• MCP SDK：實現 MCP 服務器接口
• Express：提供 HTTP 服務
• 飛書開放 API：訪問飛書文檔內容

📄 許可證

MIT

⚠️ 重要提示

應用需要有訪問飛書雲文檔的權限。