Feishu/lark

🚀 lark - mcp使用指南

lark - mcp是一款用於集成飛書/Lark API功能的工具，支持多種API調用、多語言界面，還能通過插件擴展功能，可用於開發測試、企業應用構建等場景。

🚀 快速開始

在安裝完成後，可以通過以下命令啟動MCP服務：

lark-mcp --app-id=<your_app_id> --app-secret=<your_app_secret>

默認情況下，MCP服務會在localhost:8092端口運行。

為了方便使用，可以將常用參數通過環境變量配置：

# 配置文件路徑
export LARK_MCP_CONFIG="./config.json"

# 設置應用ID和密鑰
export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"

# 啟動服務
lark-mcp

示例配置文件如下：

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret",
  "port": 8092,
  "enableApis": ["im.v1.message.create", "im.v1.chat.create"]
}

📦 安裝指南

可以通過以下命令安裝lark - mcp：

npm install -g @larksuiteoapi/lark-mcp

如果需要指定版本，請運行：

npm install -g @larksuiteoapi/lark-mcp@x.x.x # 替換為具體的版本號

✨ 主要特性

核心功能

• API代理：支持從消息創建到文件管理等多種API調用。
• 多語言支持：提供中文和英文雙語界面，滿足不同用戶需求。
• 插件擴展：支持通過插件形式擴展更多功能。

使用場景

• 開發測試：幫助開發者快速集成Feishu/Lark的API功能。
• 企業應用：用於構建高效的企業內部工具和服務。
• 教學示例：作為學習和教學的優秀案例資源。

📚 詳細文檔

FAQ

• 問題：無法連接到Feishu/Lark API

  • 解答：檢查網絡是否正常，並確認APP_ID和APP_SECRET是否正確。確保能夠訪問Feishu/Lark開放平臺，可能需要配置代理服務器。

• 問題：使用user_access_token時出現錯誤

  • 解答：檢查token是否過期。通常user_access_token的有效時間為2小時，需定期刷新。可實現自動刷新機制或改用app_access_token。

• 問題：啟動MCP服務後無法調用某些API，提示權限不足

  • 解答：核實應用是否已獲取相關API權限。部分API需要額外的高級權限，在開放平臺控制檯配置審批。

• 問題：圖片或文件上傳/下載相關的API調用失敗

  • 解答：當前版本暫不支持文件和圖片的上傳/下載功能，未來版本將逐步完善。

相關鏈接

• Feishu 開放平臺
• Lark 國際版開放平臺
• Feishu API 文檔
• Node.js 官網
• npm 文檔

反饋

歡迎通過以下方式提供反饋或報告問題：

• 郵箱：support@larksuiteoapi.com
• GitHub 倉庫：前往提交Issue