Voipbin MCP

🚀 音声IPモデルコンテキストプロトコル (VoIP) サーバー

音声IPモデルコンテキストプロトコル (VoIP MCP) サーバーは、音声IP関連のタスクを管理および実行するためのツールです。外部システムとの通信や、様々な機能モジュールをサポートします。

🚀 クイックスタート

音声IPモデルコンテキストプロトコル (VoIP MCP) サーバーは、音声IP関連のタスクを管理および実行するためのツールです。このサーバーは、モデルコンテキストプロトコルを介して外部システムと通信し、呼管理、エージェント管理、チャットメッセージ送信などの複数の機能モジュールをサポートします。

✨ 主な機能

• 多プラットフォーム互換性: 異なるオペレーティングシステムでの実行をサポートします。
• 高可用性: フォールトトレラント設計を採用し、長時間の安定した動作を保証します。
• 拡張性: 新しい機能モジュールやツールを簡単に追加できます。
• セキュリティ: 不正アクセスを防止するための組み込みセキュリティ機構が備わっています。

📦 インストール

ローカル開発環境の構築

1. 依存関係のインストール

   pip install -r requirements.txt
   

2. サーバーの起動

   python server.py
   

Docker でのデプロイ

1. イメージの構築

   FROM python:3.9-slim
   WORKDIR /app
   COPY . .
   RUN pip install --no-cache-dir -r requirements.txt
   EXPOSE 5000
   CMD ["python", "server.py"]
   

2. コンテナの実行

   docker build -t voip-mcp-server .
   docker run -p 5000:5000 voip-mcp-server
   

💻 使用例

基本的な使用法

発信

{
  "name": "make_call",
  "arguments": {
    "phone_number": "+1234567890"
  }
}

着信応答

{
  "name": "answer_call",
  "arguments": {}
}

📚 ドキュメント

機能モジュール

呼管理 (Call Management)

• 発信
• 着信応答
• 転送
• 切断

エージェント管理 (Agent Management)

• エージェントパラメータの設定
• エージェントの状態監視
• エージェント情報の更新

チャットメッセージ送信 (Chat Message Sending)

• テキストメッセージの送信
• リッチテキストメッセージの送信
• チャット履歴の管理

サーバーの実行

ローカルでの実行

# 基本的な起動
python server.py

# 設定ファイルを指定した起動
python server.py --config config.json

Docker コンテナ内での実行

docker exec -it voip-mcp-container python server.py

ツールの注釈

各ツールには、以下を含むメタデータラベルが付けられています。

• readOnlyHint: ツールがデータを読み取るだけかどうかを識別します。
• destructiveHint: ツールがデータを変更または削除するかどうかを識別します。
• idempotentHint: 繰り返し呼び出しが同じ結果をもたらすかどうかを識別します。
• openWorldHint: ツールがオープン環境で実行されるかどうかを識別します。

エラー処理

サーバーには、以下を含む包括的なエラー処理機構が組み込まれています。

• 無効な API 資格情報
• ネットワーク接続問題
• 無効なリクエストパラメータ
• レート制限
• サーバー側のエラー

開発ガイド

新しいツールの追加

1. list_tools() 関数で新しいツールを登録します。
2. 対応する処理関数を実装します。
3. 関連ドキュメントを更新します。

テスト

テストスイートを実行します。

pytest tests/

セキュリティに関する注意事項

• 資格情報の保護: API 資格情報は環境変数に保存されます。
• 認証: すべてのリクエストは認証が必要です。
• 暗号化通信: API 通信には HTTPS の使用が必須です。
• 入力検証: すべてのユーザー入力は厳密に検証されます。

貢献ガイド

1. プロジェクトリポジトリを Fork します。
2. 機能ブランチを作成します。
3. コードをコミットし、リモートリポジトリにプッシュします。
4. Pull Request を送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。詳細は以下の通りです。

MIT License

Copyright (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

⚠️ 重要提示

本文書の内容は参考用です。作者は、本ソフトウェアの使用によって生じる直接的、間接的、付随的、特殊的、例示的または結果的な損害について責任を負いません。使用前に関連する法律条項をよくお読みください。