MCP & CLI · 连接你的创作工作流

把平台模型接进 Cursor、Claude、Codex,或在终端与脚本里直接调用。同一把 API Key,同一份余额,对话、生图、生视频都不用换工具。

  • Node ≥ 18.3
  • npx 免安装
  • 共用一把 sk_live_ Key
doctor · 连通性检查

$ npx -y @momotoken/api-mcp doctor

✓nodeNode.js ≥ 18.3

✓baseUrltokenmei.com

✓apiKeysk_live_••••••

✓modelsGET /v1/models · 200

ready · stdio mcp

https://tokenmei.com

选择你的使用方式

先选接入方式与客户端,再按步骤完成配置。

  1. 1

    准备 API Key

    在控制台创建一把 sk_live_ 开头的 Key。MCP 与 CLI 共用同一把,按租户余额计费。 创建 API Key
  2. 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 打印同一份配置
    bash
    npx -y @momotoken/api-mcp mcp --print-config
  3. 3

    重启并验证

    重启 Cursor,新会话里 MCP 工具才会被注入。先让助手调用 momo_models_list,确认连通再开始创作。

    试着这样说

    用 momo_models_list 看看现在有哪些视频模型,再用其中一个生成 8 秒的雨夜猫咪镜头,16:9、720p。

    首次接入必须重启客户端——热重载不会注册 MCP 工具。

试试这样开始创作

把任意一段交给助手,或在终端按提示执行。模型 id 请先查一次,别凭记忆写。

  • 生视频

    镜头跟随一只橙色猫咪穿过雨夜的东京街头,霓虹倒影,慢动作水花,电影感运镜。

  • 生图

    雨夜霓虹街头的橙猫,湿润的柏油路面倒映招牌灯光,35mm 胶片质感。

  • 对话

    用三句话解释 MCP 是什么,以及它和直接调 HTTP 接口的区别。

MCP 工具

接入后助手会自动看到这些工具;只读工具不计费。

9
  • momo_models_list列可用模型,生成前先调,只读不计费
  • momo_models_get单个模型的能力与价格
  • momo_chat对话补全,消耗租户余额并返回费用
  • momo_image_generate生图,默认异步返回 taskId
  • momo_image_edit带参考图的图生图
  • momo_video_create创建视频任务,支持首尾帧与参考图
  • momo_task_get查询一次任务状态
  • momo_task_wait等待最多 45 秒,未完成按 retryAfter 继续
  • momo_asset_inline把 ≤4MB 图片内联进上下文

长任务约定:返回 taskId 就继续 momo_task_wait,单次最多 45 秒,不要重复调用创建接口。

使用指南

  1. 接入前准备

    注册后创建一把 sk_live_ Key,确认本机 Node.js ≥ 18.3。客户端与 CLI 用的是同一把 Key、同一份余额。

  2. MCP 还是 CLI

    在 AI 客户端里动嘴选 MCP;要进脚本、CI 或批处理就选 CLI。两者可以同时用,任务与账单是同一套。

  3. 连接失败怎么办

    依次查 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、粘贴配置,三分钟就能在客户端里生成第一条视频。

一句指令,在你的 AI 工具里创作 · MomoAI算力超市