Lark

🚀 飛書 MCP 服務器

飛書 MCP 服務器是一個集成了飛書/Lark API 的模型上下文協議（MCP）服務器，它能讓大語言模型（LLM）與飛書服務進行交互，為企業應用場景提供了強大的支持。

🚀 快速開始

飛書 MCP 服務器可使 LLM 與飛書服務交互。使用前需確保滿足先決條件，然後按安裝步驟操作，最後選擇合適的方式運行服務器。

✨ 主要特性

• 📇 使用飛書的聯繫人 API 查詢員工信息。
• ⏭️ 更多功能即將推出...

📦 安裝指南

先決條件

• Node.js 16 或更高版本。
• 配備 App ID 和 App Secret 的飛書/Feishu 應用。
• Claude for Desktop 或其他 MCP 客戶端。

安裝步驟

npm install
npm run build

💻 使用示例

基礎用法

您可以以兩種方式運行服務器：

1. 使用命令行參數（推薦）

npx lark-mcp <app_id> <app_secret>

將 <app_id> 和 <app_secret> 替換為您飛書應用的憑證。

2. 使用環境變量

export LARK_APP_ID=your_app_id
export LARK_APP_SECRET=your_app_secret
npx lark-mcp

高級用法

get - user - info

根據員工 ID 查詢員工信息。示例在 Claude 中的使用：

請查詢 ID 12345 的員工信息

📚 詳細文檔

開發流程

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

   npm install
   

3. 構建項目：

   npm run build
   

4. 啟動開發服務器：

   npm run dev
   

配置說明

服務器優先級使用憑證的順序如下：

1. 命令行參數。
2. 環境變量。
3. 默認值（若有）。

錯誤處理

• 服務器啟動前會驗證憑證。
• API 錯誤被妥善處理並返回給客戶端。
• 詳細錯誤信息有助於故障排除。

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻指南

1. 叉克倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建新的 Pull Request。