VicSee MCP Server

VicSee MCP 服务

通过 VicSee 提供的一组 MCP 工具，让任何 Agent 都能生成、编辑和放大 AI 视频与图像。

兼容 Hermes Agent、Claude（Desktop / Code）、Cursor、OpenClaw 以及任何兼容 MCP 的客户端。

你的 Agent 可以做什么

工具	功能
vicsee_list_models	列出可用模型（Seedance、Veo、Kling、FLUX、Nano Banana，……）及其积分费用
vicsee_estimate	参数与 vicsee_generate 相同；返回将扣除的确切积分，且不会创建任何内容
vicsee_generate	使用选定模型，将文本/图像转换为视频或图像
vicsee_get_task	轮询任务并获取完成后的媒体 URL（result.expires_at——URL 保留 7 天；请下载需要保留的内容）
vicsee_upscale_image	放大图像
vicsee_upscale_video	放大视频
vicsee_get_credits	查看积分余额

生成是异步的：vicsee_generate（或 vicsee_upscale_*）会立即返回任务 id，然后你的 Agent 轮询 vicsee_get_task，直到 status 为 completed，并读取 result.url 中的 URL。

设置

1. 在 vicsee.com → Settings → API 获取 API 密钥（以 sk- 开头）。 使用 API 需要付费方案或积分包。
2. 使用该密钥将服务添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "vicsee": {
      "command": "npx",
      "args": ["-y", "@vicsee/mcp-server"],
      "env": { "VICSEE_API_KEY": "sk-your-key-here" }
    }
  }
}

设置就这么简单——填入密钥后，你的 Agent 就可以生成内容了。

客户端配置位置

• Claude Desktop： claude_desktop_config.json → mcpServers
• Cursor： Settings → MCP → 添加服务（使用相同的 command/args/env）
• Hermes Agent / OpenClaw： 添加到 Agent 配置中的 MCP 服务部分
• Claude Code： claude mcp add vicsee -e VICSEE_API_KEY=sk-... -- npx -y @vicsee/mcp-server

可选环境变量

• VICSEE_BASE_URL — 覆盖 API 基础 URL（默认为 https://vicsee.com/api/v1）。

本地开发

pnpm install
pnpm build
VICSEE_API_KEY=sk-... node dist/index.js   # stdio server
# or run from source: VICSEE_API_KEY=sk-... pnpm dev

将 MCP 客户端指向本地构建，使用 "command": "node", "args": ["/abs/path/to/dist/index.js"]。

Agent 工作流示例

“给我做一个 5 秒的视频，内容是一只小猫追逐激光。”

1. vicsee_list_models（type: video）→ 选择例如 seedance-2-5-text-to-video（最长 30 秒）或 seedance-2-0-text-to-video（支持 1080p/4K）
2. vicsee_generate（model、prompt、duration: 5）→ { id, status: "pending" }
3. vicsee_get_task（id）……轮询……→ { status: "completed", result: { url: "https://cdn.vicsee.com/…" } }

说明

• 结果 URL 由 cdn.vicsee.com 提供——这是稳定的 VicSee CDN 链接。
• 每次生成都会消耗积分；每个模型的费用请查看 vicsee_list_models，余额请查看 vicsee_get_credits。

许可证

MIT