Vapi MCP for Cursor

Cursor 用 Vapi MCP

このプロジェクトでは、Vapi の音声 AI 機能を Cursor と統合するための Model Context Protocol（MCP）サーバーを実装しています。

セットアップ手順

1. プロジェクト構成

Vapi MCP サーバーは、次のように構成されています。

• vapi-mcp-server/ - メインのサーバーコード
  • src/ - TypeScript ソースファイル
  • dist/ - コンパイル済み JavaScript の出力先
  • .env - API キー用の環境変数

2. 環境設定

vapi-mcp-server ディレクトリに、次の変数を含む .env ファイルを作成します。

# Vapi API Keys
VAPI_ORG_ID=your-org-id
VAPI_PRIVATE_KEY=your-private-key
VAPI_KNOWLEDGE_ID=your-knowledge-id
VAPI_JWT_PRIVATE=your-jwt-private

# Environment
NODE_ENV=development

3. サーバーのビルド

サーバーをビルドするには、次を実行します。

cd vapi-mcp/vapi-mcp-server
npm install
npm run build

4. Cursor での設定

重要：「Client Closed」エラーの回避

Cursor の MCP 設定で Vapi MCP サーバーを設定する際は、次の重要な点に注意してください。

1. 作業ディレクトリ：サーバーが正しいディレクトリで実行され、.env ファイルに適切にアクセスできるように、cwd パラメーターが必要です。

2. 環境変数：.env ファイルに設定されている場合でも、設定内で明示的に指定する必要があります。

3. モジュールタイプ：サーバーは ES モジュールを使用するため、package.json に "type": "module" を含める必要があります。

.cursor/mcp.json の正しい設定は次のとおりです。

"Vapi Voice AI Tools": {
  "command": "node",
  "type": "stdio",
  "args": [
    "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server/dist/index.js"
  ],
  "cwd": "/Users/matthewcage/Documents/AA-GitHub/MCP/vapi-mcp/vapi-mcp-server",
  "env": {
    "VAPI_ORG_ID": "your-org-id",
    "VAPI_PRIVATE_KEY": "your-private-key",
    "VAPI_KNOWLEDGE_ID": "your-knowledge-id",
    "VAPI_JWT_PRIVATE": "your-jwt-private",
    "NODE_ENV": "development"
  }
}

トラブルシューティング

Cursor で「Client Closed」エラーが発生する場合

Cursor の MCP Tools パネルに「Client Closed」と表示される場合：

1. 作業ディレクトリを確認：mcp.json で cwd パラメーターが正しく設定されていることを確認します
2. 環境変数を確認：必要な環境変数がすべて設定内で渡されていることを確認します
3. モジュールタイプを確認：package.json に "type": "module" が設定されていることを確認します
4. 権限を確認：dist/index.js ファイルが実行可能であることを確認します（chmod +x dist/index.js）
5. サーバーを直接テスト：手動でサーバーを実行し、エラーがないか確認します。

   cd vapi-mcp/vapi-mcp-server
   node --trace-warnings dist/index.js
   

モジュールが見つからないエラー

実行時に「Error: Cannot find module」が表示される場合：

1. 作業ディレクトリを確認：正しいディレクトリから実行していますか？
2. 再ビルド：npm run build でプロジェクトを再ビルドしてみてください
3. 依存関係：npm install ですべての依存関係がインストールされていることを確認します

利用可能なツール

Vapi MCP サーバーでは、次のツールを利用できます。

1. vapi_call - Vapi の音声 AI を使用して発信します
2. vapi_assistant - 音声アシスタントを管理します（作成、取得、一覧表示、更新、削除）
3. vapi_conversation - 通話の会話詳細を取得します

得られた教訓

1. Cursor の MCP と統合する際は、次の点に注意してください。

   • サーバーが正しいディレクトリで実行されるよう、必ず cwd パラメーターを指定します
   • 必要な環境変数をすべて MCP の設定に直接渡します
   • ES モジュールの場合は、package.json に "type": "module" が設定され、tsconfig.json で適切なモジュール設定が使用されていることを確認します
   • Cursor で設定する前に、サーバーを直接テストします

2. サーバーコマンドのパスは、Cursor MCP の設定で絶対パスとして正しく指定する必要があります

3. Cursor と適切に統合するには、stdio トランスポートタイプが必要です