飞书开放API MCP 增强
这是飞书/乐高官方的OpenAPI MCP（模型上下文协议）工具，旨在帮助用户快速连接到飞书/乐高平台，并实现AI代理与飞书/乐高的高效协作。该工具将飞书/乐高开放平台API接口封装为MCP工具，允许AI助手直接调用这些接口并实现各种自动化场景，如文档处理、会话管理、日程安排等。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"lark-mcp": {
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"\u003cyour_app_id\u003e",
"-s",
"\u003cyour_app_secret\u003e"
],
"command": "npx"
}
}
}该服务需要配置环境变量：APP_ID、APP_SECRET
服务介绍
飞书/飞聊 OpenAPI MCP
English | 中文
⚠️ 测试版通知: 该工具目前处于测试阶段。功能和API可能会发生变化，请关注版本更新。
这是飞书/飞聊官方的OpenAPI MCP（Model Context Protocol）工具，旨在帮助用户快速连接到飞书/飞聊平台，并实现AI代理与飞书/飞聊之间的高效协作。该工具将飞书/飞聊开放平台的API接口封装为MCP工具，使AI助手可以直接调用这些接口，实现诸如文档处理、会话管理、日程安排等多种自动化场景。
准备工作
创建飞书/飞聊应用
在使用lark-mcp工具之前，您需要创建一个飞书/飞聊应用：
- 访问飞书开放平台或飞聊开放平台并登录
- 点击“控制台”并创建一个新的应用
- 获取App ID和App Secret，这将用于API认证
- 根据您的使用场景添加必要的权限
- 如果您需要以用户身份调用API，请将OAuth 2.0重定向URL设置为http://localhost:3000/callback
有关详细的应用创建和配置指南，请参阅飞书开放平台文档 - 创建应用。
安装Node.js
在使用lark-mcp工具之前，您需要安装Node.js环境。
使用官方安装程序（推荐）：
- 访问Node.js官网
- 下载并安装LTS版本
- 安装完成后，在终端中验证：
node -v
npm -v
快速开始
与Trae/Cursor/Claude一起使用
要将飞书/飞聊功能集成到像Trae、Cursor或Claude这样的AI工具中，请使用以下按钮进行安装。
或者将以下内容添加到您的配置文件中：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>"
]
}
}
}
如果您需要以用户身份访问API，首先需要在终端中使用登录命令进行登录。请注意，您需要先在开发者控制台中配置应用的重定向URL，默认为http://localhost:3000/callback
# Login and get user access token
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy
# Or optionally, login with specific OAuth scope - if not specified, all permissions will be authorized by default
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy --scope offline_access docx:document
然后将以下内容添加到您的配置文件中：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>",
"--oauth",
"--token-mode", "user_access_token"
]
}
}
}
注意：启用--oauth时，建议显式设置--token-mode为user_access_token，这意味着使用用户访问令牌调用API，适用于访问用户资源或需要用户授权的场景（如读取个人文档、发送IM消息）。如果保持默认的auto，某些API可能会回退到tenant_access_token，这可能导致权限不足或无法访问用户的私有数据。
域名配置基于您的使用场景，lark-mcp 支持配置不同的域名环境：
飞书（中国版）:
- 默认使用
https://open.feishu.cn域名 - 适用于中国用户
Lark（国际版）:
- 使用
https://open.larksuite.com域名 - 适用于海外用户或 Lark 国际版
要切换到 Lark 国际版，请在配置中添加 --domain 参数：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>",
"--domain",
"https://open.larksuite.com"
]
}
}
}
💡 提示: 确保您的应用程序是在相应域名环境的开放平台上创建的。国际版应用程序不能与飞书中国版一起使用，反之亦然。
自定义 API 配置
⚠️ 文件上传/下载: 文件上传和下载操作尚不支持
⚠️ 文档编辑: 不支持直接编辑飞书云文档（仅支持导入和读取）
默认情况下，MCP 服务启用了常用 API。要启用其他工具或仅特定 API 或预设，您可以在 MCP 客户端配置（JSON）中使用 -t 参数指定它们：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a", "<your_app_id>",
"-s", "<your_app_secret>",
"-t", "im.v1.message.create,im.v1.message.list,im.v1.chat.create,preset.calendar.default"
]
}
}
}
有关所有预设工具集以及每个预设中包含哪些工具的详细信息，请参阅 预设工具集参考。
所有支持的飞书/Lark 工具的完整列表可以在 tools.md 中找到。
⚠️ 注意：非预设 API 尚未经过兼容性测试，在理解和使用过程中 AI 可能不会表现最佳。
开发集成
开发者可以参考 Agent 集成的最小示例：lark-samples/mcp_quick_demo。
您还可以参考 Lark 机器人集成示例：lark-samples/mcp_larkbot_demo/nodejs。
该示例展示了如何将 MCP 功能集成到飞书/Lark 机器人中，通过机器人对话触发工具调用和消息发送，适用于将现有工具集成到 Bot 的场景。
高级配置
有关详细的配置选项和部署场景，请参阅我们的 配置指南。
有关所有可用命令行参数及其用法的详细信息，请参阅 命令行参考。
常见问题解答
相关链接
反馈
欢迎提出问题以帮助改进此工具。如果您有任何问题或建议，请在 GitHub 仓库中提出。
