VicSee MCP Server

VicSee MCP Server

任意のエージェントから AI 動画・画像を生成、編集、アップスケールできます。VicSeeを MCPツールとして利用できます。

Hermes Agent、Claude（Desktop / Code）、Cursor、OpenClawや、MCP 対応のあらゆるクライアントで利用できます。

エージェントでできること

ツール	機能
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をすぐに返します。その後、エージェントはstatusがcompletedになるまでvicsee_get_taskをポーリングし、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" }
    }
  }
}

セットアップはこれだけです。キーを入力すれば、エージェントで生成できるようになります。

クライアント設定ファイルの場所

• Claude Desktop: claude_desktop_config.json → mcpServers
• Cursor: Settings → MCP → サーバーを追加（同じcommand／args／envを使用）
• Hermes Agent / OpenClaw: エージェント設定の 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

"command": "node", "args": ["/abs/path/to/dist/index.js"]を指定して、MCP クライアントからローカルビルドを参照します。

エージェントの使用例

「レーザーを追いかける子猫の 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