Feishu MCP

🚀 飛書 MCP 服務器

飛書 MCP 服務器為飛書（Feishu/Lark）應用提供了 Model Context Protocol (MCP) 服務。它允許 AI 大模型藉助工具調用與飛書 API 進行交互，目前主要聚焦於多維表格操作，極大提升了飛書應用在數據處理方面的靈活性和效率。

✨ 主要特性

• 基於 Model Context Protocol (MCP) TypeScript SDK 構建，藉助成熟的 SDK 保障服務的穩定性和兼容性。
• 提供飛書多維表格操作工具，方便用戶對多維表格進行各類操作。
• 支持 HTTP + SSE 通信，為數據傳輸提供了高效、即時的解決方案。

📦 安裝指南

# 安裝依賴項
npm install

# 構建項目
npm run build

# 開發模式運行
npm run dev

# 通過標準輸入輸出運行MCP
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}"

# 通過SSE（服務器發送事件）運行MCP
node dist/index.js --sse --config "{\" appId\": \"xxx\", \" appSecret\": \"xxx\"}"

💻 使用示例

基礎用法

以下是在飛書多維表格中創建一條新記錄的示例：

# 調用 create_record 工具創建新記錄
# 假設已經配置好環境，這裡僅展示調用示例
# 具體參數需要根據實際情況填寫
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool create_record --params "{\"tableId\":\"xxx\",\"fields\":{\"field1\":\"value1\",\"field2\":\"value2\"}}"

高級用法

在多維表格中搜索符合條件的記錄，並對搜索結果進行批量更新：

# 先搜索符合條件的記錄
node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool search_records --params "{\"tableId\":\"xxx\",\"filter\":\"field1 = 'value1'\"}"

# 假設搜索結果存儲在一個變量中，例如 result
# 然後對搜索結果中的記錄進行批量更新
for record in result.records; do
  node dist/index.js --config "{\"appId\":\"xxx\",\"appSecret\":\"xxx\"}" --tool update_record --params "{\"tableId\":\"xxx\",\"recordId\":\"$record.id\",\"fields\":{\"field2\":\"new_value\"}}"
done

📚 詳細文檔

已實現工具

create_record

在飛書多維表格中創建一條新記錄。

update_record

在飛書多維表格中更新一條記錄。

list_fields

獲取多維表格數據表中的所有字段。

search_records

在多維表格中搜索符合條件的記錄。

delete_record

刪除多維表格中的一條記錄。

create_bitable_app

創建一個新的飛書多維表格應用。

create_table

創建飛書多維表格中的一個新數據表。

飛書API參考文檔

• 飛書多維表格API文檔
• 創建記錄API
• 獲取記錄API
• 搜索記錄API
• 刪除記錄API
• 創建多維表格應用API
• 創建數據表API
• 列出字段信息

📄 許可證

本項目採用 MIT 許可證。