Voyp Model Context Protocol server

Voyp Model Context Protocol サーバー

Model Context Protocol（MCP）は、AI システムがさまざまなデータソースやツールとシームレスに連携できるようにするオープンスタンダードで、安全な双方向接続を実現します。

Anthropic が開発した Model Context Protocol（MCP）により、Claude などの AI アシスタントを VOYP の通話機能とシームレスに連携できます。この連携によって、AI モデルは電話をかけ、通話の進行状況を監視できるようになります。

Voyp MCP サーバーでは、次のことができます。

• 通話時に使用する堅牢な通話コンテキストを構築する
• レストランや歯科医院などへの電話時に、事業者情報を検索する
• 電話をかけて、予約、申し込み、相談、問い合わせなどを行う
• 通話状況を確認する
• 通話を終了する

前提条件 🔧

Voyp を使用する前に、以下が必要です。

• Voyp API キー
  • 通話に使用するクレジットも購入する必要があります。クレジットはこちらから購入することもできます。
• Claude Desktop、Goose、またはその他の互換性のあるクライアント
• Node.js（v20 以降）
  • 次のコマンドを実行して、Node.js がインストールされていることを確認できます。
    • node --version
• Git のインストール（Git を使用したインストール方法の場合のみ必要）
  • macOS の場合：brew install git
  • Linux の場合：
    • Debian/Ubuntu：sudo apt install git
    • RedHat/CentOS：sudo yum install git
  • Windows の場合：Git for Windows をダウンロードしてください。

リモート Voyp MCP サーバー（Http Streamable）

ストリーム対応エンドポイントに直接接続できます。

https://api.voyp.app/mcp/stream

Voyp は OAuth2 認証フローに対応しています。

リクエストには Voyp API キーまたは OAuth2 アクセストークンを指定した Authorization ヘッダーを追加する必要があります。

Authorization: Bearer sk_xyz

Goose 用 Voyp MCP サーバーのインストール ⚡（Stdio）

voyp-mcp サーバーをインストールするには、拡張機能を手動で追加する必要があります。

Voyp + Goose のデモ：

Claude Desktop 用 Voyp MCP サーバーのインストール ⚡（Stdio）

voyp-mcp サーバーをインストールするには、次の方法を使用できます。

1. Smithery 経由でインストールする
2. NPX で実行する
3. Git でインストールする

1. Smithery 経由でインストールする

Smithery 経由で Claude Desktop 用の Voyp Model Context Protocol サーバーを自動的にインストールするには：

npx -y @smithery/cli install @paulotaylor/voyp-mcp --client claude

2. NPX で実行する

npx -y [email protected]   

サーバー単体で起動することもできますが、単独ではあまり役に立ちません。代わりに、MCP クライアントに統合してください。以下に、voyp-mcp サーバーと連携するよう Claude Desktop アプリを設定する例を示します。

Claude Desktop アプリの設定 ⚙️

macOS の場合：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows の場合：

code %APPDATA%\Claude\claude_desktop_config.json

Voyp サーバーの設定を追加する：

your-VOYP-api-key を実際のVOYP API キーに置き換えてください。

{
  "mcpServers": {
    "voyp-mcp": {
      "command": "npx",
      "args": ["-y", "voyp-mcp"],
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
      }
    }
  }
}

3. Git でインストールする

1. リポジトリをクローンします：

git clone https://github.com/paulotaylor/voyp-mcp.git
cd voyp-mcp

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

Claude Desktop アプリの設定 ⚙️

上記のClaude Desktop アプリの設定セクションの手順に従い、以下の JSON 設定を使用してください。

your-VOYP-api-key-here を実際のVOYP API キーに、/path/to/voyp-mcp をシステム上でリポジトリをクローンした実際のパスに置き換えてください。

{
  "mcpServers": {
    "voyp": {
      "command": "npx",
      "args": ["/path/to/voyp-mcp/build/index.js"],
      "env": {
        "VOYP_API_KEY": "your-VOYP-api-key"
      }
    }
  }
}

Claude Desktop アプリでの使用 🎯

インストールが完了し、Claude デスクトップアプリの設定が済んだら、v oyp-mcp サーバーを表示するために、Claude デスクトップアプリを完全に終了してから再起動してください。アプリの左下にハンマーアイコンが表示され、利用可能な MCP ツールを確認できます。ハンマーアイコンをクリックすると、start_call ツールと hangup_call ツールの詳細を確認できます。

これで Claude は、start_call ツールと hangup_call ツールを含め、voyp-mcp サーバーに完全にアクセスできるようになります。

Voyp + Claude Desktop のデモ：

トラブルシューティング 🛠️

よくある問題

1. サーバーが見つからない

   • npm --verison を実行して、npm のインストールを確認します。
   • code ~/Library/Application\ Support/Claude/claude_desktop_config.json を実行して、Claude Desktop の設定構文を確認します。
   • node --version を実行して、Node.js が正しくインストールされていることを確認します。

2. NPX 関連の問題

• npx に関連するエラーが発生した場合は、代わりに npx 実行ファイルのフルパスを指定する必要がある場合があります。
• ターミナルで which npx を実行してパスを確認し、設定内の "command": "npx" の行を "command": "/full/path/to/npx" に置き換えてください。

3. API キーの問題
   • VOYP API キーが有効であることを確認します。
   • 設定で API キーが正しく指定されていることを確認します。
   • API キーの前後に空白や引用符がないことを確認します。

謝辞 ✨

• MCP 仕様を提供してくださった Model Context Protocol
• Claude Desktop を提供してくださった Anthropic