AI导哈

文档访问服务器

一个用于搜索和访问Lark(飞书)文档的模型上下文协议服务器，支持文档内容检索、认证和错误处理。

  • by T0UGH
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 T0UGH/mcp_server_my_lark_doc

使用说明

MCP服务器我的Lark文档

一种用于搜索和访问Lark（Feishu）文档的模型上下文协议服务器。

特性

文档内容访问

  • 同时支持Lark Doc和Wiki文档类型
  • 自动处理文档类型检测和ID提取
  • 以文本格式返回原始内容以供LLM处理

认证

  • 基于OAuth的用户身份验证
  • 自动令牌刷新和过期管理
  • 可定制的OAuth回调服务器

错误处理

  • 针对身份验证问题的全面错误报告
  • 清除无效文档URL的反馈
  • 用于故障排除的详细错误消息

安装

uvx mcp-server-my-lark-doc

配置

获取您的Lark应用ID和应用密码

访问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. 获取您的应用ID和应用密码
  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检索文档内容
    • Args:documentUrl（字符串）-Lark文档的URL
    • 返回：文本格式的文档内容
    • 支持：
      • 文档URL：https://xxx.feishu.cn/docx/xxxxx
      • Wiki网址：https://xxx.feishu.cn/wiki/xxxxx

  2. search_wiki

    • 目的：在Lark Wiki中搜索文档
    • Args：
      • query（字符串）-搜索关键字
      • page_size（int，可选）-要返回的结果数（默认值：10）
    • 返回：包含以下字段的搜索结果的JSON字符串：
      • title：文档标题
      • url：文档url
      • create_time：文档创建时间
      • update_time：文档上次更新时间

错误消息

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

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

开发说明

OAuth回调服务器

默认配置：

  • 主机：本地主机

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

  • OAUTH_HOST：设置回调服务器主机

  • OAUTH_PORT：设置回调服务器端口

许可证

MIT许可证

相关 MCP