@velxor/mcp

MCP（Model Context Protocol）サーバーです。Claude Code、Cursor、その他MCP対応エージェントが、コーディングセッションから直接、Vlexorの3つの柱（AI動画編集、ゲームアセット生成、モーショングラフィックス制作）すべてを操作できるようにします。

動画編集は自分の映像素材で動作します。生の動画は決してマシンから送信されません。指示のテキスト（およびオプションの文字起こし）のみがVlexorに送信されて編集計画が生成され、それが実際のFFmpegコマンドにコンパイルされ、すべてローカルでレンダリングされます。アセット生成とモーショングラフィックスはサーバーサイドでレンダリングされ（保護すべきローカル映像はありません）、署名付きダウンロードURLを返します。必要に応じてローカルパスに直接保存することもできます。

セットアップ

1. Vlexor → 設定 → MCP & API で個人用APIキーを生成します。

2. FFmpegがまだインストールされていない場合はインストールします（macOSでは brew install ffmpeg、または VLEXOR_FFMPEG_DIR に ffmpeg/ffprobe があるフォルダを指定します）。

3. MCPクライアントの設定に以下を追加します。

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: Cognitive Core

ツール

柱1 — 動画編集（ローカルでレンダリング、映像はアップロードされません）：

• probe_media — ローカル動画の長さ、解像度、フレームレート、コーデックを読み取ります。

• generate_edit_plan — 自然言語の指示 → 構造化された編集計画（実際のVlexor Command Engineを呼び出します。プランの使用量にカウントされます）。

• compile_edit_plan — 編集計画 → 実際のFFmpegコマンド。すべてローカルで計算されます。

• render — コンパイルされたコマンドをローカルで実行し、最終的な動画を生成します。

典型的なエージェントの流れ：probe_media → generate_edit_plan →（手順を確認）→ compile_edit_plan →（FFmpegコマンドを確認）→ render。

柱2 — アセット生成（サーバーサイドでレンダリング）：

• generate_game_asset — プロンプト → テクスチャ、2Dキャラクター、スプライトシート、3Dモデル（.glb）、効果音、音楽トラック、パララックス背景、またはキャラクターターンアラウンド。署名付きダウンロードURLを返します。savePath を指定するとファイルをローカルに書き込みます。

柱3 — モーショングラフィックス（サーバーサイドでレンダリング）：

• generate_motion_graphic — 短いクリエイティブブリーフ → レンダリングされたキネティックタイトル .mp4（告知/プロモーションカード）。署名付きダウンロードURLを返します。savePath を指定するとファイルをローカルに書き込みます。

環境変数

このリポジトリについて

このパッケージは、MCPクライアントをVlexorの実際のホスト型APIに接続する薄い統合レイヤーです。ここでのすべてのツール呼び出しは、プレーンで検査可能なHTTPリクエストです（何がマシンから送信されるかは src/api-client.ts で正確に確認できます）。APIキーを経由してパイプするエージェント開発者が自分で検証できるように、オープンになっています。

Vlexorプラットフォーム自体（編集エンジン、AIプロンプト設計、アセット/モーショングラフィックス生成パイプライン）はクローズドソースです。このパッケージの一部のインポート（@velxor/engine のFFmpeg計画コンパイラ、@velxor/shared の型定義）はそのプライベートコードベースからのものであり、個別に公開されていません。そのため、このリポジトリは単独で pnpm install/ビルドすることはできません。これは読むためのものであり、事前ビルドされたnpmパッケージ（npx -y @velxor/mcp）を介して実行することを意図しており、このチェックアウトからコンパイルするものではありません。

MCP統合レイヤー自体（ツールスキーマ、エラーハンドリング、ローカルFFmpegオーケストレーション）に関するIssueやPRは歓迎します。

ライセンス

MIT