Lark Doc

🚀 Lark 文檔管理 MCP 服務器

這是一個用於搜索和訪問 Lark（飛書）文檔的 Model Context Protocol 服務器，能幫助用戶便捷地處理飛書文檔，為 LLM 提供純文本格式的文檔內容。

中文文檔

⚠️ 重要提示

在使用此 MCP 服務器之前，您需要有一個 Lark 企業應用。如果您還沒有創建，請按照下面的設置說明進行操作。

✨ 主要特性

文檔內容訪問

• 支持 Lark Doc 和 Wiki 文檔類型。
• 自動處理文檔類型檢測和 ID 提取。
• 返回純文本格式的內容供 LLM 處理。

認證

• 基於 OAuth 的用戶認證。
• 自動刷新令牌和過期管理。
• 可自定義的 OAuth 回調服務器。

錯誤處理

• 全面的身份驗證問題報告。
• 清晰的無效文檔 URL 反饋。
• 詳細的錯誤消息用於故障排除。

📦 安裝指南

uvx mcp-lark-doc-manage

📚 詳細文檔

創建您的 Lark 企業應用

1. 訪問 Lark 開放平臺。
2. 點擊右上角的“開發者控制檯”。
3. 點擊“創建自建應用”。
4. 填寫基本信息：
   • 應用名稱
   • 應用描述
   • 應用圖標
5. 在“安全設置”部分：
   • 將您的域名添加到“請求域名白名單”。
   • 配置 OAuth 2.0 設置。
6. 啟用所需的 capability 和在“權限管理”中申請權限。
7. 提交審核並等待批准。

有關詳細說明，請參閱 自建應用開發流程。

獲取 App ID 和 App Secret

1. 獲取 App ID：
   • 轉到您在 開發者控制檯 中的應用。
   • 點擊應用卡片中的“查看應用查看詳情”。
   • 在“應用概覽”頁面中，找到並複製“App ID”。
2. 獲取 App Secret：
   • 在同一個應用的“設置”菜單下，選擇“開發者信息”。
   • 找到“生成密鑰”按鈕並點擊。
   • 在彈出窗口中，點擊“生成”以獲取 App Secret。

配置回調地址（可選）

如果需要配置回調地址，請在應用的“設置”菜單下，選擇“授權回調地址”，添加您的回調 URL。

環境變量配置

您可以在 config.json 文件中設置以下環境變量：

{
  "LARK_APP_ID": "your_app_id",
  "LARK_APP_SECRET": "your_app_secret",
  "LARK_CALLBACK_DOMAIN": "your_callback_domain"
}

獲取 Folder Token

要獲取文件夾令牌，請按照以下步驟操作：

1. 登錄 Lark 並導航到您需要獲取令牌的文件夾。
2. 複製文件夾 URL 地址。
3. 在 MCP 服務器中，設置環境變量 FOLDER_TOKEN 為該 URL 地址。

💻 使用示例

基礎用法

列出文檔

# 列出指定文件夾中的文檔
curl -X GET "http://localhost:8080/api/list Documents?pageSize=10"

# 列出所有文檔（不帶路徑）
curl -X GET "http://localhost:8080/api/list"

搜索 Wiki 文檔

curl -X GET "http://localhost:8080/api/searchWiki?query=test&pageSize=5"

創建新文檔

curl -X POST "http://localhost:8080/api/createDoc" \
     -H "Content-Type: application/json" \
     -d '{"title":"新建文檔","content":"# 新建文檔\n歡迎使用 MCP 服務器！"}'

🔧 錯誤處理

獲取文檔內容失敗

• 錯誤信息：Failed to get document content
• 解決方法：
  1. 檢查文檔權限。
  2. 確保令牌有效。
  3. 如果問題持續，聯繫 Lark 支持團隊。

🔧 技術細節

OAuth 回調服務器

默認配置：

• 主機：localhost
• 端口：9997

通過環境變量自定義：

• OAUTH_HOST：設置回調服務器主機
• OAUTH_PORT：設置回調服務器端口

📄 許可證

MIT License