Feishu/lark

Feishu/Lark官方OpenAPI MCP工具，封装平台API接口，支持AI助手直接调用实现文档处理、会话管理等自动化场景

开发者工具通信工具 #飞书API #自动化工具 #AI集成 #协作平台 .TypeScript

评分 : 2.5分

下载量 : 8.0K

更新时间 : 2025-04-28

打开站点

什么是飞书/Lark MCP服务器？

飞书/Lark MCP服务器是一个工具集，旨在帮助用户快速接入飞书/Lark平台，并实现高效协作。它封装了飞书/Lark开放平台的API接口，支持消息管理、群组操作、文档处理、日程安排等功能。

如何使用飞书/Lark MCP服务器？

通过简单的配置，您可以启动MCP服务器并与AI助手集成，从而实现自动化任务处理。

适用场景

适用于需要自动化文档处理、群组管理、日程安排等任务的企业和个人开发者。

主要功能

即时通讯

支持发送消息、获取消息列表以及创建群聊。

文档操作

允许读取和编辑飞书文档内容。

日历管理

支持创建和管理日程事件。

Bitable数据表

提供Bitable应用的创建、数据表管理和记录搜索功能。

联系人管理

批量获取用户ID等联系人信息。

优势

支持多种认证方式（App Token & User Token）。

提供灵活的通信协议（stdio & SSE）。

几乎覆盖所有飞书/Lark核心API。

易于集成至第三方AI工具中。

局限性

当前版本不支持文件上传下载功能。

部分高级权限需手动申请并审批。

国际版域名需手动指定。

如何使用

安装Node.js环境

确保您的系统已安装Node.js（推荐LTS版本）。

创建飞书/Lark应用

在飞书开放平台或Lark开放平台上创建应用并获取App ID和App Secret。

启动MCP服务器

运行命令启动MCP服务。

集成至AI工具

根据需求配置MCP服务器地址和参数。

使用案例

创建群聊

通过MCP服务器创建一个新群聊。

发送消息

向指定用户发送一条测试消息。

常见问题

无法连接到飞书/Lark API。

使用user_access_token时出现错误。

某些API调用失败，提示权限不足。

无法上传或下载文件。

🚀 lark - mcp使用指南

lark - mcp是一款实用工具，支持多种API调用、多语言，还能通过插件扩展功能，可用于开发测试、企业应用等场景。

🚀 快速开始

在安装完成后，可以通过以下命令启动MCP服务：

lark-mcp --app-id=<your_app_id> --app-secret=<your_app_secret>

默认情况下，MCP服务会在localhost:8092端口运行。

📦 安装指南

可以通过以下命令安装lark - mcp：

npm install -g @larksuiteoapi/lark-mcp

如果需要指定版本，请运行：

npm install -g @larksuiteoapi/lark-mcp@x.x.x # 替换为具体的版本号

💻 使用示例

基础用法

为了方便使用，可以将常用参数通过环境变量配置：

# 配置文件路径
export LARK_MCP_CONFIG="./config.json"

# 设置应用ID和密钥
export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"

# 启动服务
lark-mcp

高级用法

以下是示例配置文件：

{
  "app_id": "your_app_id",
  "app_secret": "your_app_secret",
  "port": 8092,
  "enableApis": ["im.v1.message.create", "im.v1.chat.create"]
}

✨ 主要特性

核心功能

API代理：支持从消息创建到文件管理等多种API调用。
多语言支持：提供中文和英文双语界面，满足不同用户需求。
插件扩展：支持通过插件形式扩展更多功能。

使用场景

开发测试：帮助开发者快速集成Feishu/Lark的API功能。
企业应用：用于构建高效的企业内部工具和服务。
教学示例：作为学习和教学的优秀案例资源。

📚 详细文档

FAQ

问题：无法连接到Feishu/Lark API
- 解答：检查网络是否正常，并确认APP_ID和APP_SECRET是否正确。确保能够访问Feishu/Lark开放平台，可能需要配置代理服务器。
问题：使用user_access_token时出现错误
- 解答：检查token是否过期。通常user_access_token的有效时间为2小时，需定期刷新。可实现自动刷新机制或改用app_access_token。
问题：启动MCP服务后无法调用某些API，提示权限不足
- 解答：核实应用是否已获取相关API权限。部分API需要额外的高级权限，在开放平台控制台配置审批。
问题：图片或文件上传/下载相关的API调用失败
- 解答：当前版本暂不支持文件和图片的上传/下载功能，未来版本将逐步完善。