Vapi MCP

🚀 Vapi MCP の Cursor への実装

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

✨ 主な機能

• Vapi の音声 AI 機能を Cursor と統合する。
• Model Context Protocol (MCP) サーバーを提供する。

📦 インストール

環境構成

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

# Vapi API キー
VAPI_ORG_ID=your-org-id
VAPI_PRIVATE_KEY=your-private-key
VAPI_KNOWLEDGE_ID=your-knowledge-id
VAPI_JWT_PRIVATE=PRIVATE>PRIVATE>PRIVATE>PRIVATE=your-jwt-private

## 環境設定
NODE_ENV=development

サーバーのビル ド ル ール

サーバーをビル ー ー ー ー ールするにに は、以下の� � � � � � � コマン ドを を を を を を を を を を実行します。

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

💻 使用例

Cursor で の設定 設定 設定

⚠️ 重要な注意事

Cursor の Cursor の MCP 設定で Vapi MCP サーバー ー を を を を設定する場合、以下の重要事項 を守ってください。

1. ** 作業� ディレクトリ：cwd パラメータは必須で、サーバーが正しいディレ レ レクト ト トリで動作し、.env フ�� � � � � ァイルに正しく アク� � � � � � � セス スで できるようにする し し し します。
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 で「クライアントが閉じられました」エラーが発生した場合

Cursor の MCP ツールパネルで「クライアントが閉じられました」と表示される場合は、以下の手順を試してください。

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

モジュールが見つからないエラーが発生した場合

「エラー：モジュールが見つかりません」というエラーが発生する場合は、以下の手順を試してください。

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

利用可能なツール

Vapi MCP サーバーが提供するツールには、以下のものが含まれます。

• vapi-mcp-server/src/index.ts：リクエストをリッスンして処理するためのメインサーバーファイル。
• vapi-mcp-server/dist/index.js：コンパイルされたメイン実行ファイル。

🔧 技術詳細

Vapi MCP サーバーは、Model Context Protocol (MCP) を使用して Vapi の音声 AI 機能を Cursor と統合します。サーバーは Node.js で構築され、ES モジュールを使用しています。

📄 ライセンス

このプロジェクトのライセンス情報は提供されていません。

💡 使用上の提案

1. すべての環境変数が正しく設定され、.env ファイルがプロジェクトのルートディレクトリにあることを確認してください。
2. 本番環境で使用する前に、サーバーが十分にテストされ、適切なエラー処理とログ記録メカニズムが設定されていることを確認してください。
3. 問題が発生したり、さらに質問がある場合は、Vapi の公式ドキュメントを参照するか、サポートチームに連絡してください。

以上の手順に従えば、Vapi の音声 AI 機能を Cursor と統合し、MCP プロトコルを使用してデータをやり取りすることができます。