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应用程序凭据：
- 在Lark开放平台中创建Lark应用程序
- 获取您的应用ID和应用密码
- 配置环境变量：
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
}
}
}可用工具
- get_lark_doc_content
- 目的：从Lark检索文档内容 - Args:documentUrl（字符串）-Lark文档的URL - 返回：文本格式的文档内容 - 支持： - 文档URL：https://xxx.feishu.cn/docx/xxxxx - Wiki网址：https://xxx.feishu.cn/wiki/xxxxx
- 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许可证