Vidofy

@vidofy/mcp

适用于 Vidofy 的 MCP 服务——可通过 Claude、ChatGPT、VS Code、Gemini CLI、Cursor、Hermes 或任何 MCP 客户端生成图像、视频、音频和语音，费用从你自己的 Vidofy 账户扣除，价格与网站收费相同。

支持 570 多种模型，包括 Veo 3.1、Kling 3.0、Flux 2、Seedance 2.5、Wan 2.7、 Hailuo 2.3、Runway、Luma Ray 2、Qwen Image 3.0、Vidu Q3 和 LTX 2 — 涵盖文本生成视频、图像生成视频、文本生成图像、图像编辑、视频和照片特效、口型同步、 文本转语音和声音克隆。Agent 可以浏览目录、在开始生成前估算费用，并跟进生成任务直至获取结果。

状态：首次公开发布。

此服务面向个人 Vidofy 账户。 它只接受一个凭据， VIDOFY_TOKEN，并使用你自己的金币——与网站使用同一余额， 价格也相同。没有其他计费方式：启动时会拒绝 VIDOFY_API_KEY， 这是有意为之，并非等待后续版本推出的功能。

工具

工具	功能	是否消耗金币
list_modes	Vidofy 可生成的内容：文本生成图像、图像生成视频、口型同步、语音……	否
list_models	某种模式下的模型，以及每种模型的积分费用和大致耗时	否
get_model	单个模型的完整输入规范：JSON Schema、文件槽位及其限制	否
estimate_cost	开始生成前，估算生成任务的费用	否
generate	执行生成任务。唯一会扣除余额的工具。	是
get_status	查询生成任务是否已完成	否
get_result	获取已完成任务的媒体文件	否
get_balance	查看剩余金币，以及订阅到期时会失效的金币数量	否
get_usage	查看近期生成任务及其费用	否

常见调用顺序为 list_modes → list_models → get_model → estimate_cost → generate → get_status → get_result。

generate 是唯一没有 readOnlyHint 的工具；该标记会告知客户端，运行前应先询问用户。它会在提交时扣费，而不是在生成成功后扣费，并立即返回一个 ID — 生成任务耗时约 30 秒到数分钟，因此 Agent 会轮询 get_status，而不是让调用一直等待。输出默认设为私有；只有在用户要求永久公开链接时，才传入 public: true。

文件输入需要提供运行服务的机器上的路径。软件包会读取用户自己的文件，并在提交时将其流式传输——绝不会创建临时副本——还会先根据对应模型的限制检查文件扩展名和大小，因此服务会拒绝的文件不会离开磁盘。

**有意不提供：**结账、自动充值、购买、推荐奖励、每日奖励。无论收到什么提示，这个软件包都无法购买金币或更改套餐。

设置

有两种接入方式。除非你的客户端不支持第一种，否则请优先选择第一种。

1. 远程连接器 — 无需安装

向客户端提供此 URL：

https://vidofy.ai/mcp-app

你只需在浏览器中登录并批准一次。无需复制令牌，无需在配置文件中保留任何内容，也无需在此软件包变更时进行更新。

客户端	操作
Claude.ai · Claude Desktop	设置 → 连接器 → 添加自定义连接器 → 粘贴 URL → 连接，然后批准登录。两者共用一个列表：在任一客户端中添加后，它都会出现在两者中。所有套餐均可使用，包括 Free 套餐（可添加一个连接器）。
ChatGPT	设置 → 连接器 → 添加自定义连接器（没有此选项？请先在设置中开启开发者模式）→ 粘贴 URL → 连接，然后批准登录。在 Business 或 Enterprise 工作区中，管理员可为所有人添加。
VS Code	添加一个类型为 http 的 MCP 服务，并使用上方的 URL，然后在浏览器中批准登录。VS Code 会使用其自行发布的客户端元数据标识自身，因此无需注册，也无需获取客户端密钥。
Claude Code · Codex · Cursor	这些客户端都支持远程 MCP 服务 URL。请参阅相应客户端自己的 MCP 文档，并提供上方的 URL。

接着询问它："list Vidofy modes"，确认连接正常；再问 "make me a 5-second clip of a red bicycle"——它会先计算生成费用，再开始运行。

有些客户端无法使用这种方式，尝试之前值得了解原因。 在此登录需要客户端使用已发布的元数据文档标识自身——这是授权服务器会获取的 https URL。另一些客户端则要求在 registration_endpoint 注册自身，或要求提供你手动创建的 client_id 和 client_secret；这类客户端无法使用此方式，因为本服务器既不提供注册端点，也不签发这些凭据。Gemini CLI 和 Hermes 目前都属于这一类。请使用方式 2——它并不逊色，只是验证身份的方式不同。

2. 本地 stdio 服务 — 适用于此处的所有客户端

前往 vidofy.ai → Studio → Account → MCP Access 创建个人 MCP 令牌。令牌只会显示一次。

// claude_desktop_config.json   (Cursor: .cursor/mcp.json — same shape)
{
  "mcpServers": {
    "vidofy": {
      "command": "npx",
      "args": ["-y", "@vidofy/mcp"],
      "env": { "VIDOFY_TOKEN": "vmt_..." }
    }
  }
}

首次运行时，npx 会下载它。想使用固定版本？运行 npm i -g @vidofy/mcp，然后：

{ "command": "vidofy-mcp", "env": { "VIDOFY_TOKEN": "vmt_..." } }

各处的配置项相同——但配置文件和外层键名各不相同。 粘贴前，请根据客户端自己的文档检查配置：

客户端	文件	外层键
Claude Desktop	claude_desktop_config.json	mcpServers
Cursor	.cursor/mcp.json	mcpServers
Gemini CLI	settings.json，用户级或项目级	mcpServers
VS Code	.vscode/mcp.json，或用户配置文件中的 mcp.json	servers — 每个条目还需添加 "type": "stdio"
Hermes	Hermes 主目录中的 config.yaml	mcp_servers — 使用 YAML，而非 JSON

因此，VS Code 需要：

// .vscode/mcp.json
{
  "servers": {
    "vidofy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vidofy/mcp"],
      "env": { "VIDOFY_TOKEN": "vmt_..." }
    }
  }
}

Hermes 则需要同样的内容，但使用 YAML：

mcp_servers:
  vidofy:
    command: npx
    args: ["-y", "@vidofy/mcp"]
    env:
      VIDOFY_TOKEN: "vmt_..."

两种方式都可访问同一账户、同一组模型和同一余额。两者的区别仅在于进程运行的位置，以及验证身份的方式。

有一个客户端能显示比其他客户端更多的内容。 通常，生成结果会以文本形式返回，供模型读取。支持 MCP Apps 的宿主则会显示实时卡片——图片或视频片段本身、生成过程中的进度，以及下载按钮——而且只有当宿主表示支持渲染时，服务才会提供此卡片。Claude 和 VS Code 都支持（在 VS Code 中，请开启 chat.mcp.apps.enabled）。其他客户端收到的结果相同，只是以文本形式呈现；如果结果是图片，则会以内嵌图片的形式显示。内容并未缺失，只是呈现得更简洁。

环境

变量	必填	用途
VIDOFY_TOKEN	是	个人 MCP 令牌（vmt_…）。使用你自己的 Vidofy coins，与工作室中的用法完全相同。
VIDOFY_API_BASE	否	覆盖服务连接的源站——只能是源站，不能包含路径。默认为 https://vidofy.ai，这正是你需要的值。

VIDOFY_API_KEY 仅用于识别并拒绝：vky_… 密钥会从不同的余额中扣费，此服务不支持该密钥。设置此变量会导致启动停止，并提示应改用哪个令牌；同时设置两个变量也会遭到拒绝，因为它们会从不同的余额中扣费，而且不值得为了记住优先级规则而增加麻烦。

开发

npm install
npm run build
npm run inspect      # MCP Inspector — spends nothing

如果你正在运行其他源站，可以用 VIDOFY_API_BASE 将它指向该源站。

这里的任何内容都不会写入 stdout。 使用 stdio 传输时，stdout 就是协议通道——哪怕只有一条多余的 console.log()，也会在流中写入非 JSON 行，客户端随即会断开连接，并报出一个毫无解释的错误。诊断信息会通过 src/index.ts 中的 log() 帮助函数写入 stderr。

目录结构

src/config.ts          credential + mode + base URL, validated at startup
src/backend.ts         the only place that talks HTTP: auth, retries, multipart, errors
src/schema.ts          one model's m_options → a JSON Schema the agent can fill in
src/map/b2c.ts         both response shapes → one; strips the provider cost
src/tools/info.ts      list_modes, list_models, get_model
src/tools/generation.ts estimate_cost, generate, get_status, get_result
src/tools/account.ts   get_balance, get_usage
src/index.ts           the server: stdio transport, tool registration, annotations


server.json     MCP registry manifest (name must match package.json "mcpName")

许可证

MIT