MCP Server My Lark Doc

MCP 服务 My Lark Doc

用于搜索和访问 Lark（飞书）文档的模型上下文协议服务。

功能

文档内容访问

• 支持 Lark Doc 和 Wiki 两种文档类型
• 自动检测文档类型并提取 ID
• 以文本格式返回原始内容，供大模型处理

身份验证

• 基于 OAuth 的用户身份验证
• 自动刷新令牌并管理有效期
• 可自定义 OAuth 回调服务

错误处理

• 全面报告身份验证问题
• 清晰提示无效的文档 URL
• 提供详细的错误消息，便于排查问题

安装

uvx mcp-server-my-lark-doc

配置

获取 Lark App ID 和 App Secret

访问 Lark 开放平台：https://open.larkoffice.com/app

确保你的 Lark 应用具有以下权限

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

环境变量

使用此 MCP 服务前，你需要设置 Lark 应用凭据：

1. 在 Lark 开放平台创建 Lark 应用
2. 获取 App ID 和 App Secret
3. 配置环境变量：

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"
export OAUTH_HOST="localhost"               # OAuth callback server host (default: localhost)
export OAUTH_PORT="9997"                   # OAuth callback server port (default: 9997)

使用方法

在 Claude 桌面端进行配置：

"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  
        }
    }
}

可用工具

1. get_lark_doc_content

   • 用途：从 Lark 获取文档内容
   • 参数：documentUrl（字符串）—— Lark 文档的 URL
   • 返回：文本格式的文档内容
   • 支持：
     • Doc URL：https://xxx.feishu.cn/docx/xxxxx
     • Wiki URL：https://xxx.feishu.cn/wiki/xxxxx

2. search_wiki

   • 用途：搜索 Lark Wiki 中的文档
   • 参数：
     • query（字符串）—— 搜索关键词
     • page_size（整数，可选）—— 返回结果数量（默认值：10）
   • 返回：包含搜索结果的 JSON 字符串，包含以下字段：
     • title：文档标题
     • url：文档 URL
     • create_time：文档创建时间
     • update_time：文档最后更新时间

错误消息

常见错误消息及其解决方法：

• “Lark 客户端未正确初始化”：检查你的 LARK_APP_ID 和 LARK_APP_SECRET
• “Lark 文档 URL 格式无效”：检查文档 URL 格式
• “获取文档内容失败”：检查文档权限和令牌有效性
• “获取应用访问令牌失败”：检查应用凭据和网络连接
• “获取 Wiki 文档真实 ID 失败”：检查 Wiki 文档是否存在，以及你是否拥有相应权限
• “文档内容为空”：文档可能为空，或者你可能无权访问其内容
• “授权超时”：用户未能在 5 分钟内完成授权

开发说明

OAuth 回调服务

默认配置：

• 主机：localhost

• 端口：9997 可通过环境变量自定义：

• OAUTH_HOST：设置回调服务主机

• OAUTH_PORT：设置回调服务端口

许可证

MIT 许可证