Feishu Project(Meego) Connector - Bytedance Internal Version
by @wadxm
通过 MCP 服务连接 Meego(飞书项目字节内网版),支持 OAuth 认证,可查询和管理工作项、视图等。
clawhub install feishu-project-connector-bytedance-internal📖 About This Skill
name: feishu-project-connector description: 通过 MCP 服务连接 Meego(飞书项目字节内网版),支持 OAuth 认证,可查询和管理工作项、视图等。 version: 1.0.10 homepage: https://www.npmjs.com/package/@lark-project/meego-mcporter metadata: openclaw: homepage: https://www.npmjs.com/package/@lark-project/meego-mcporter emoji: 📋 requires: bins: - node - npx config: - ~/.mcporter/credentials.json install: - kind: node package: "@lark-project/meego-mcporter" bins: - meego-mcporter
Meego (飞书项目字节内网版) Skill
通过 MCP 服务连接 Meego(飞书项目字节内网版),支持 OAuth 认证。
前置要求
本技能依赖以下环境:
npxnpm install -g @lark-project/meego-mcporter 或通过 npx 自动获取)凭证管理说明
本技能使用 ~/.mcporter/credentials.json 存储 OAuth 凭证(由 mcporter 管理)。
安全约束:
~/.mcporter/ 的位置连接方式
1. 询问用户使用哪种方式进行认证
注意:一定要询问用户,让用户主动选择,禁止自动帮用户选择。 本工具支持两种认证方式:
2. 浏览器 OAuth(推荐)
#### 2.1. 创建配置文件
将技能包目录中的 meego-config.json 拷贝到工作目录下。
#### 2.2. 执行 OAuth 认证(只需一次)
npx @lark-project/meego-mcporter auth meego_btd --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_btd --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://bytedance.larkoffice.com/wiki/UspfwpHaFi6LxQkt9xBcIS54nNg 在本地电脑中完成授权,授权完成后请将生成的凭证文件提供给我。
步骤 B — 接收用户提供的已授权凭证(需用户确认):
用户在本地完成 OAuth 后会提供已授权的凭证文件。在得到用户确认后,将其写入 ~/.mcporter/credentials.json。
写入完成后,立即清理操作过程中可能产生的任何中间临时文件。凭证内容仅存储在 ~/.mcporter/credentials.json,不得保存到其他任何位置。
#### 3.4. 验证授权结果
尝试连接 MCP 服务器,确认已成功通过授权。
4. 后续使用
npx @lark-project/meego-mcporter call meego_btd --config meego-config.json