MCP & CLI · 连接你的创作工作流
把平台模型接进 Cursor、Claude、Codex,或在终端与脚本里直接调用。同一把 API Key,同一份余额,对话、生图、生视频都不用换工具。
- Node ≥ 18.3
- npx 免安装
- 共用一把 sk_live_ Key
$ npx -y @momotoken/api-mcp doctor
✓nodeNode.js ≥ 18.3
✓baseUrltokenmei.com
✓apiKeysk_live_••••••
✓modelsGET /v1/models · 200
ready · stdio mcp
选择你的使用方式
先选接入方式与客户端,再按步骤完成配置。
- 1
准备 API Key
在控制台创建一把 sk_live_ 开头的 Key。MCP 与 CLI 共用同一把,按租户余额计费。 创建 API Key - 2
写入配置
把下面的片段写进 Cursor:项目内 .cursor/mcp.json,或全局 ~/.cursor/mcp.json.cursor/mcp.json{ "mcpServers": { "momo-api": { "command": "npx", "args": ["-y","@momotoken/api-mcp","mcp"], "env": { "MOMO_API_BASE_URL": "https://tokenmei.com", "MOMO_API_KEY": "<YOUR_API_KEY>" } } } }保存后在 Settings → MCP 里确认 momo-api 已连接、工具数不为 0。
配置里是明文本地 Key,只放进可信目录,别提交到仓库。
用 CLI 打印同一份配置
bashnpx -y @momotoken/api-mcp mcp --print-config - 3
重启并验证
重启 Cursor,新会话里 MCP 工具才会被注入。先让助手调用 momo_models_list,确认连通再开始创作。试着这样说
用 momo_models_list 看看现在有哪些视频模型,再用其中一个生成 8 秒的雨夜猫咪镜头,16:9、720p。
首次接入必须重启客户端——热重载不会注册 MCP 工具。
试试这样开始创作
把任意一段交给助手,或在终端按提示执行。模型 id 请先查一次,别凭记忆写。
生视频
镜头跟随一只橙色猫咪穿过雨夜的东京街头,霓虹倒影,慢动作水花,电影感运镜。
生图
雨夜霓虹街头的橙猫,湿润的柏油路面倒映招牌灯光,35mm 胶片质感。
对话
用三句话解释 MCP 是什么,以及它和直接调 HTTP 接口的区别。
MCP 工具
接入后助手会自动看到这些工具;只读工具不计费。
momo_models_list列可用模型,生成前先调,只读不计费momo_models_get单个模型的能力与价格momo_chat对话补全,消耗租户余额并返回费用momo_image_generate生图,默认异步返回 taskIdmomo_image_edit带参考图的图生图momo_video_create创建视频任务,支持首尾帧与参考图momo_task_get查询一次任务状态momo_task_wait等待最多 45 秒,未完成按 retryAfter 继续momo_asset_inline把 ≤4MB 图片内联进上下文
长任务约定:返回 taskId 就继续 momo_task_wait,单次最多 45 秒,不要重复调用创建接口。
使用指南
接入前准备
注册后创建一把 sk_live_ Key,确认本机 Node.js ≥ 18.3。客户端与 CLI 用的是同一把 Key、同一份余额。
MCP 还是 CLI
在 AI 客户端里动嘴选 MCP;要进脚本、CI 或批处理就选 CLI。两者可以同时用,任务与账单是同一套。
连接失败怎么办
依次查 Key、源站地址和客户端权限。任务超时不要重新提交,先 task get 查原任务,避免重复扣费。
常见问题
需要完整参数? 读 CLI / MCP 文档
MCP、CLI 和 SDK 怎么选?
在 AI 客户端里创作选 MCP;在终端、脚本和 CI 里跑选 CLI;写自己的服务端应用选 SDK 或直接调 /v1。三者共用同一套模型、计费与产物地址。
可以在哪些客户端里使用?
任何支持 stdio 的 MCP 客户端都行:Cursor、Claude Code、Claude Desktop、Codex、VS Code、Windsurf、Cline、Cherry Studio 等。配置只有 command、args、env 三项,换个客户端照抄即可。
第一次用 CLI 需要装什么?
只需要 Node.js ≥ 18.3。npx 可以免安装直接跑,也可以 npm i -g @momotoken/api-mcp 装成全局的 momo-api。
Key 用哪一把?额度怎么算?
用租户下任意一把 sk_live_ Key 即可,价格和 /v1 完全一致,按成功调用计费。只读工具(模型列表、任务查询)不计费。
生成要等多久?超时需要重新提交吗?
生图通常十几秒,生视频按秒数从几十秒到几分钟。返回 taskId 后用 momo_task_wait 或 task wait 继续等,不要重复调用创建接口——重复创建会重复扣费。
支持自己的参考图和首尾帧吗?
支持。MCP 用 references / firstFrame / lastFrame,CLI 用 --ref、--first-frame、--last-frame;本地文件会转成 data URL 上传(单张 ≤10MB)。
产物在哪里?能长期保存吗?
任务完成会返回稳定 URL,但建议下载到本地:CLI 用 -o 落盘,超过保留期后链接会失效。
能放进 CI 或脚本里跑吗?
可以。CLI 提供 --json / --jsonl、--dry-run 和固定退出码(0 成功、3 Key 无效、4 余额不足、5 限流、9 超时),方便流水线判断。
把创作放进你已经在用的工具里
注册、创建 Key、粘贴配置,三分钟就能在客户端里生成第一条视频。