MCP Server My Lark Doc

基本能力

产品定位

MCP Server My Lark Doc 是一个专门用于搜索和访问 Lark（飞书）文档的服务，支持 Doc 和 Wiki 两种文档类型，适用于需要集成 Lark 文档内容的自动化流程和 LLM 处理场景。

核心功能

1. 文档内容访问
2. 支持 Lark Doc 和 Wiki 文档类型
3. 自动处理文档类型检测和 ID 提取

4. 返回文本格式的原始内容供 LLM 处理

5. 认证

6. 基于 OAuth 的用户认证
7. 自动令牌刷新和过期管理

8. 可定制的 OAuth 回调服务器

9. 错误处理

10. 全面的认证问题错误报告
11. 无效文档 URL 的清晰反馈
12. 详细的错误消息用于故障排除

适用场景

• 自动化流程中需要访问 Lark 文档内容
• LLM 处理 Lark 文档内容
• 需要搜索 Lark Wiki 文档的场景

工具列表

1. get_lark_doc_content
2. 用途：从 Lark 检索文档内容
3. 参数：documentUrl (string) - Lark 文档的 URL
4. 返回：文本格式的文档内容

5. 支持：

   • Doc URLs: https://xxx.feishu.cn/docx/xxxxx
   • Wiki URLs: https://xxx.feishu.cn/wiki/xxxxx

6. search_wiki

7. 用途：在 Lark Wiki 中搜索文档
8. 参数：
   • query (string) - 搜索关键词
   • page_size (int, 可选) - 返回结果数量（默认：10）
9. 返回：包含搜索结果的 JSON 字符串

常见问题解答

• "Lark client not properly initialized": 检查 LARK_APP_ID 和 LARK_APP_SECRET
• "Invalid Lark document URL format": 验证文档 URL 格式
• "Failed to get document content": 检查文档权限和令牌有效性
• "Failed to get app access token": 检查应用程序凭据和网络连接
• "Failed to get wiki document real ID": 检查 Wiki 文档是否存在以及您是否有适当的权限
• "Document content is empty": 文档可能为空或您可能无法访问其内容
• "Authorization timeout": 用户在 5 分钟内未完成授权

使用教程

使用依赖

1. 访问 Lark 开放平台：https://open.larkoffice.com/app
2. 确保您的 Lark 应用具有以下权限：

wiki:wiki:readonly
wiki:node:read
docx:document:readonly
search:docs:read

安装教程

uvx mcp-server-my-lark-doc

配置环境变量

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"
export OAUTH_HOST="localhost"               # OAuth 回调服务器主机（默认：localhost）
export OAUTH_PORT="9997"                   # OAuth 回调服务器端口（默认：9997）

调试方式

在 Claude desktop 中配置：

"mcpServers": {
    "lark_doc": {
        "command": "uvx",
        "args": ["mcp-server-my-lark-doc"],
        "env": {
            "LARK_APP_ID": "your app id",
            "LARK_APP_SECRET": "your app secret",
            "OAUTH_HOST": "localhost",   // optional   
            "OAUTH_PORT": "9997"        // optional  
        }
    }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。