Vonageaicodeassist

🚀 Vonage AI コード補助 MCP サーバー

Vonage AI コード補助 MCP サーバーは、開発者が Vonage API 機能をアプリケーションに統合するのを支援するツールです。FastMCP を利用して AI 補助機能を提供し、開発者は Vonage の公式ドキュメントを迅速に参照し、Vonage 通信 API に関連する情報を効率的に検索できます。

🚀 クイックスタート

Vonage Assist MCP サーバーを使用するには、まずサーバーをセットアップする必要があります。以下の手順に従って操作してください。

✨ 主な機能

• 専用ツール "Vonage - Assist" を通じて、Vonage の公式ドキュメントを検索できます。
• Google Serper API を利用して、特定のドメイン内で的確な検索が可能です。
• Claude や他の MCP プロトコル対応の AI アシスタントと互換性があり、Vonage ドキュメントを直接利用して応答を生成できます。

📦 インストール

Vonage Assist MCP サーバーを実行するには、以下の手順に従ってください。

1. Python 3.13 以上がインストールされていることを確認します。
2. 必要な環境変数を設定します。
   • SERPER_API_KEY：Google Serper API キー（ウェブ検索用、必須）
3. 依存関係をインストールします。

   uv install
   

4. サーバーを起動します。

   python main.py
   

💻 使用例

サーバーが起動した後、"Vonage - Assist" ツールは以下のパラメータで設定できます。

基本的な使用法

使用 Vonage-Assist 工具查找关于如何在 Vonage API 中实现双因素认证的信息。

高度な使用法

• query：検索クエリ（例："番号検証"、"SMS API"）
• library：検索対象のドキュメントライブラリ（現在は "vonage" のみサポート）

📚 ドキュメント

動作原理

Vonage Assist MCP サーバーの動作フローは以下の通りです。

1. ドキュメント検索：サーバーは "Vonage - Assist" という専用ツールを提供し、Vonage の公式ドキュメント内を検索します。
2. ウェブ検索統合：Google Serper API を通じて、Vonage 開発者ドキュメントの特定ドメイン (developer.vonage.com/en/documentation) 内で的確な検索を実行します。
3. コンテンツ抽出：検索クエリを送信すると、サーバーは以下の操作を行います。
   • クエリに基づいてウェブサイト向けの検索リクエストを生成します。
   • リクエストを Google Serper API に送信します。
   • 関連するドキュメントのリンクを含む検索結果を受け取ります。
   • これらのリンクからコンテンツを取得します。
   • 抽出したテキストコンテンツをユーザーに返します。
4. MCP ツール統合：サーバーは Claude や他の MCP プロトコル対応の AI アシスタントと互換性があり、これらの AI システムが直接 Vonage ドキュメントを利用して応答を生成できるようにします。

🔧 技術詳細

サーバーは以下の技術を用いて構築されています。

• FastMCP：MCP サーバーフレームワーク
• httpx：非同期 HTTP リクエスト用
• BeautifulSoup：HTML 解析とテキスト抽出用
• python - dotenv：環境変数管理用

主要な機能はいくつかの重要な関数によって実現されています。

• search_web()：Google Serper API のリクエストを実行します。
• fetch_url()：ウェブページのコンテンツを取得して抽出します。
• vonage_docs()：主なツール関数で、検索とコンテンツ取得のプロセスを調整します。

未来の開発計画

Vonage Assist MCP サーバーの潜在的な改善方向は以下の通りです。

1. コード生成ツール：一般的な Vonage API 統合コードスニペット（SMS、Voice、Verify、Video など）を生成する機能を追加し、開発者が API 機能を迅速に実装できるようにし、正しい構文とベストプラクティスを提供します。
2. API パラメータアシスタント：開発者が有効な API リクエストを構築できるようにするツールを開発し、パラメータを提案し、入力を検証し、さまざまな Vonage API エンドポイントの必須およびオプションフィールドを説明します。
3. トラブルシューティングアシスタント：一般的な統合問題を診断する機能を実装し、エラーコードを分析し、知識ベースの記事とドキュメントに基づいて解決策を提供し、デバッグ時間を大幅に削減します。
4. ゲートウェイ構成ツール：開発者が Vonage サービスのゲートウェイエンドポイントを設定およびテストできるようにする補助ツールを作成し、コールバックとイベント処理のプロセスをガイドします。
5. ベストプラクティスアドバイザー：コンテキストに基づいて、パフォーマンス、セキュリティ、および弾力性のベストプラクティスを提案する機能を追加し、開発者がより信頼性の高いアプリケーションを構築できるように支援します。
6. レート制限と料金見積もりツール：開発者が具体的なユースケースに基づいてコストを見積もり、Vonage のレート制限を理解できるようにするツールを提供します。