Feishu Project(Meego) Connector
通过 MCP 服务连接 Meego(飞书项目),支持 OAuth 认证,可查询和管理工作项、视图等。
Like a lobster shell, security has layers — review code before you run it.
License
Runtime requirements
Install
npm i -g @lark-project/meego-mcporterSKILL.md
Meego (飞书项目) Skill
通过 MCP 服务连接 Meego(飞书项目),支持 OAuth 认证。
前置要求
本技能依赖以下环境:
- Node.js(>= 18)及
npx - @lark-project/meego-mcporter:MCP 传输工具,来源 npm(
npm install -g @lark-project/meego-mcporter或通过npx自动获取)
凭证管理说明
本技能使用 ~/.mcporter/credentials.json 存储 OAuth 凭证(由 mcporter 管理)。
- 方式一(推荐):浏览器 OAuth——mcporter 自动完成授权并写入凭证,agent 无需接触凭证内容。
- 方式二(远程服务器):当服务器没有浏览器时,需要用户在本地电脑完成 OAuth 后将凭证同步到服务器。此流程中 agent 会协助展示 OAuth 客户端配置(不含 token)以及写入用户提供的已授权凭证,所有操作均需用户逐步确认。
安全约束:
- agent 不得自主发起凭证操作,每一步均需用户明确确认
- agent 不得将凭证内容记录到日志、历史消息或任何非
~/.mcporter/的位置 - 操作过程中产生的临时文件必须立即清理
连接方式
1. 询问用户使用哪种方式进行认证
注意:一定要询问用户,让用户主动选择,禁止自动帮用户选择。 本工具支持两种认证方式:
- 浏览器 OAuth(推荐):适用于本地安装 OpenClaw 的场景,自动调起浏览器完成授权
- 远程 OAuth 代理:适用于在远程服务器(无浏览器环境)安装 OpenClaw 的场景
2. 浏览器 OAuth(推荐)
2.1. 创建配置文件
将技能包目录中的 meego-config.json 拷贝到工作目录下。
2.2. 执行 OAuth 认证(只需一次)
npx @lark-project/meego-mcporter auth meego --config meego-config.json
这会打开浏览器让你授权飞书账号。授权完成后,凭证会缓存到 ~/.mcporter/credentials.json,后续调用不需要再次授权。
3. 远程 OAuth 代理
适用场景:远程服务器没有浏览器,用户需要在本地电脑完成 OAuth 后将凭证同步回服务器。
3.1. 创建配置文件
将技能包目录中的 meego-config.json 拷贝到工作目录下。
3.2. 生成 OAuth 客户端配置
npx @lark-project/meego-mcporter auth meego --config meego-config.json --oauth-timeout 1000
此命令会在 ~/.mcporter/credentials.json 中生成 OAuth 客户端配置(仅包含 client 参数,不含 token)。
3.3. 协助用户完成本地授权
此步骤需要 agent 与用户配合完成凭证同步。由于远程服务器没有浏览器,用户需要在本地电脑完成 OAuth 授权。
步骤 A — 向用户展示 OAuth 客户端配置(需用户确认):
读取 ~/.mcporter/credentials.json 的内容(此时仅包含 OAuth 客户端参数,不含 token),向用户展示并告知:
以下是 OAuth 客户端配置,请参考文档 https://project.feishu.cn/b/helpcenter/1ykiuvvj/1n3ae9b4 在本地电脑中完成授权,授权完成后请将生成的凭证文件提供给我。
步骤 B — 接收用户提供的已授权凭证(需用户确认):
用户在本地完成 OAuth 后会提供已授权的凭证文件。在得到用户确认后,将其写入 ~/.mcporter/credentials.json。
写入完成后,立即清理操作过程中可能产生的任何中间临时文件。凭证内容仅存储在 ~/.mcporter/credentials.json,不得保存到其他任何位置。
3.4. 验证授权结果
尝试连接 MCP 服务器,确认已成功通过授权。
4. 后续使用
npx @lark-project/meego-mcporter call meego <tool_name> --config meego-config.json
可用功能
- 查询:待办、视图、工作项信息
- 操作:创建、修改、流转工作项
Files
3 totalComments
Loading comments…
