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 のみと通信します。それ以外の認証情報は保持せず、API キーを使った 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