v0 MCP Server

v0 Platform APIを使って自然言語の要件からプロトタイプのURLを返すMCPサーバーです。

機能

generate_prototype: 自然言語の要件を受け取り、v0 Platform APIを使ってプロトタイプを生成し、デモURLを返します

セットアップ

依存関係のインストール:

npm install

環境変数の設定: MCPクライアント側で以下の環境変数を設定してください：

V0_API_KEY=your_v0_api_key_here

ビルド:

npm run build

使用方法

MCPクライアントでの使用

MCPクライアントの設定で以下のようにサーバーを追加します：

{
  "mcpServers": {
    "v0-mcp-server": {
      "command": "node",
      "args": ["/path/to/v0-mcp-server/dist/index.js"],
      "env": {
        "V0_API_KEY": "your_v0_api_key_here"
      }
    }
  }
}

ツールの使用例

const result = await mcpClient.callTool('generate_prototype', {
  requirements: 'Reactを使ったTODOアプリを作成してください。ダークモード対応で、ローカルストレージに保存する機能も含めてください。'
});

// 成功時のレスポンス例：
// {
//   "success": true,
//   "chatId": "chat_123",
//   "demoUrl": "https://v0.dev/chat/demo_url",
//   "files": [...],
//   "createdAt": "2025-01-xx T xx:xx:xx.xxxZ"
// }

開発

テスト実行

MCPインスペクターを使用してテストできます：

npm run inspector

ブラウザでインスペクターUIが開き、ツールの動作を確認できます。

開発モード

npm run dev

API

generate_prototype

パラメータ:

requirements (string, 必須): プロトタイプの要件を自然言語で記述
model (string, オプション): 使用するモデル ("v0-1" | "v0-2", デフォルト: "v0-2")

戻り値: 成功時は生成されたプロトタイプのURL、ファイル情報、チャットIDを含むJSONを返します。エラー時はエラー情報を含むJSONを返します。