猫大叔创意平台智能体桥接工具

CLI 命令 + MCP 服务，统一调度导演分镜大师、视频生成与素材仓库。

一行安装

先按公司提供的私有 Registry 凭据完成 npm login，再选择使用的智能体客户端：

npx -y -p @maodashu/agent-bridge maodashu setup --client codebuddy
npx -y -p @maodashu/agent-bridge maodashu setup --client cursor
npx -y -p @maodashu/agent-bridge maodashu setup --client claude
npx -y -p @maodashu/agent-bridge maodashu setup --client codex

如果已全局安装过，也可直接用：maodashu setup --client codex

安装器会：

• 注册名为 maodashu 的 stdio MCP 服务，不删除其他 MCP 服务。
• 安装 6 个内置 Skills。
• 不执行登录、不保存服务端密钥、不读取公司模型验证码。

预览将要写入的位置而不改动配置：

maodashu setup --client codebuddy --dry-run

检查安装状态：

maodashu setup status --client codebuddy

升级到私有 Registry 中的最新版本后，重复执行对应的 setup 命令即可更新 MCP 配置和 Skills：

npm install -g @maodashu/agent-bridge@latest
maodashu setup --client codebuddy

本地开发

cd agent-bridge
npm install
npm run build
npm link
maodashu setup --client codebuddy

CLI 使用

# 登录
maodashu auth login

# 查看状态
maodashu auth status

# 诊断登录态（检查凭据、网关、令牌有效性）
maodashu auth diagnose

# 修复登录态（清理失效缓存 → 重新授权 → 验证新令牌）
maodashu auth repair

# 公司生图平台认证
maodashu auth company-ai

# 列出工具
maodashu tools list
maodashu tools list --subsite storyboard

# 调用工具
maodashu tools call storyboard_listModels
maodashu tools call storyboard_createProject --json '{"title":"测试项目"}'

# 快捷命令
maodashu storyboard create "我的分镜项目"
maodashu video create "测试视频"
maodashu material get-url "/path/to/file.png"

# 工作流
maodashu workflow run create-storyboard
maodashu workflow run produce-video-project

# JSON 输出模式
maodashu tools list --json

# 登出
maodashu auth logout

MCP 服务

安装器会自动为选定客户端登记 maodashu-mcp。需要手工启动时：

maodashu-mcp

MCP Server 使用以下网关地址：

https://ai-video-agent-226345-8-1257781291.sh.run.tcloudbase.com

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | MAODASHU_GATEWAY_URL | 网关地址 | https://ai-video-agent-226345-8-1257781291.sh.run.tcloudbase.com |

安全

• 本地令牌存储在有权限保护的本地文件或 macOS Keychain 中。
• 安装包不持有服务端密钥；浏览器授权后才换取短期令牌。
• 高风险操作需要服务端确认票据。
• maodashu auth diagnose / maodashu auth repair 输出绝不包含 access_token、refresh_token、deviceSecret 等敏感值原文。

故障排除

登录态提示 "缺少或无效的 deviceSecret"

1. 先诊断: maodashu auth diagnose
2. 查看输出，确认凭据状态和网关连通性
3. 若诊断建议 repair，执行: maodashu auth repair
4. 按提示在浏览器中完成授权确认
5. 修复成功后，执行 maodashu auth status 确认令牌可用

网络/超时问题

• maodashu auth repair 内置有限次数重试 + 指数退避，自动应对网络抖动
• 如果反复超时，检查 MAODASHU_GATEWAY_URL 环境变量及 HTTP 代理设置