AIVeed

aiveed-mcp

面向 AIVeed API 的 MCP 服务：通过 Claude、Cursor、 VS Code 或任何 MCP 客户端生成 AI 视频、图像和音频 （Veo 3.1、Seedance、Kling、Wan、Grok Imagine、GPT Image、Nano Banana 等）。生成内容使用你自己账户中的 AIVeed 额度付费。

该服务仅通过你的 API 密钥调用公开 REST API https://api.aiveed.io/v1。它不持有任何其他凭据，也无法执行你的密钥通过 curl 无法执行的操作。

工具

工具	功能	额度
list_models	实时模型目录：选项、接受的输入、价格（无需密钥）	免费
get_credits	查看你的余额	免费
generate_video / generate_image / generate_audio	启动任务并返回任务 ID	消耗额度
extend_video	为已完成的 Veo 3.1 视频增加约 7 秒	消耗额度
get_job	查看任务状态；wait_seconds 会持续轮询，直到任务完成	免费
list_jobs、list_videos、list_images	查看你的任务和媒体（永久 URL）	免费
cancel_job	取消排队中的任务（退还额度）	免费
upload_media	将本地图像/音频/视频上传为输入（仅 stdio 模式）	免费

每次生成调用都会发送一个 Idempotency-Key（在结果中返回），因此使用相同的密钥重试不会重复扣费。失败的任务会自动退还额度。

设置

在 https://developer.aiveed.io/keys 创建 API 密钥。需要 Node.js 20 或更高版本。各客户端的分步设置说明：https://api.aiveed.io/docs/mcp。

Claude Code

claude mcp add aiveed -e AIVEED_API_KEY=aiv_sk_... -- npx -y aiveed-mcp

Claude Desktop 和 Cursor（claude_desktop_config.json、~/.cursor/mcp.json）：

{
  "mcpServers": {
    "aiveed": {
      "command": "npx",
      "args": ["-y", "aiveed-mcp"],
      "env": { "AIVEED_API_KEY": "aiv_sk_..." }
    }
  }
}

VS Code（.vscode/mcp.json，或在命令面板中选择 MCP: Add Server）：

{
  "servers": {
    "aiveed": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "aiveed-mcp"],
      "env": { "AIVEED_API_KEY": "aiv_sk_..." }
    }
  }
}

如果希望升级时由你主动决定，可以固定版本（[email protected]）。

本地文件

upload_media 会将本地文件转换为模型可使用的 URL。该 URL 是公开的，因此只有在 AIVEED_MCP_UPLOAD_DIRS 中列出允许读取的文件夹后，工具才会启用，例如 "AIVEED_MCP_UPLOAD_DIRS": "~/Videos/aiveed-inputs"。请仅列出存放你愿意分享的媒体的文件夹；专门用于生成输入的文件夹最合适。即使在这些文件夹中，该工具也绝不会读取隐藏文件或文件夹、系统目录或硬链接文件，并且只会上传真实的图像、音频和视频文件（根据文件内容检查，而不仅仅是文件名）。

生成工具会消耗额度，upload_media 会公开文件，因此请为这些工具保留客户端的审批提示，不要设置为自动批准。

HTTP 模式（托管）

node dist/index.js --http --port 8787 --host 127.0.0.1

Streamable HTTP 使用 POST /mcp，采用无状态模式。--host/--port（或 AIVEED_MCP_HOST/AIVEED_MCP_PORT）用于设置地址。每个请求都必须携带调用者自己的密钥 （Authorization: Bearer aiv_sk_...）；AIVEED_API_KEY 会被忽略，因此托管实例绝不会消耗他人的额度。此模式不提供 upload_media（否则会读取主机的磁盘）。

变量	默认值
AIVEED_MCP_ALLOWED_HOSTS	localhost,127.0.0.1,[::1]	接受的 Host 标头名称（用于防范 DNS 重绑定，不用于访问控制）；如果代理后面有公网主机名，请将其添加到此处
AIVEED_MCP_ALLOWED_ORIGINS	无	允许的浏览器来源；不带 Origin 标头的请求也会被允许
AIVEED_API_URL	https://api.aiveed.io	API 源站（仅限 https；localhost 可使用 http）

请在终止 TLS 的代理后运行此服务，并设置速率限制；服务默认绑定到 127.0.0.1，超过 64 个并发请求时会返回 503。

开发

npm ci
npm test            # vitest; no network, the API is faked
npm run typecheck
npm run build       # dist/
npm run leak-scan   # credentials, private addresses, personal paths

开发工作在 development 分支上进行；main 分支保存已发布的代码。有关安全模型，请参阅 SECURITY.md；有关发布方式，请参阅 RELEASING.md。

许可证

MIT