Vonageassist

🚀 Vonage AI Code Assist

Vonage AI Code Assistは、モデルコンテキストプロトコル（MCP）に基づいて構築されたサーバーです。開発者がVonage APIの機能を自分たちのアプリケーションに統合するのを支援することを目的としています。このサーバーはFastMCPフレームワークを利用し、開発者にAI支援ツールを提供し、Vonageのドキュメントをすばやく参照し、Vonage通信APIに関する関連情報を検索できるようにします。

🚀 クイックスタート

仕組み

Vonage AI Code 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のドキュメントを使用して応答を生成できるようにします。

インストールと要件

Vonage AI Code Assist MCPサーバーを実行するには、以下の手順を完了してください。

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

uv install

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

python main.py

使用方法

サーバーが起動すると、Vonage - Assistツールは以下のパラメーターで利用できます。

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

使用例（MCP互換AIを通じて）：

Vonage - Assistツールを使用して、Vonage APIを使って2要素認証を実装する方法に関する情報を検索します。

✨ 主な機能

• 開発者がVonage API機能をアプリに簡単に統合できるよう支援します。
• Vonageの公式ドキュメントを迅速に検索できる専用ツールを提供します。
• MCP互換のAIアシスタントと連携し、AIがVonageドキュメントを利用して応答を生成できます。

🔧 技術詳細

技術構成

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

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

主要機能の実装

核心機能は以下の主要関数によって実現されています。

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

将来的なアップグレード予定

Vonage AI Code Assist MCPサーバーの将来的な潜在的な機能強化には以下が含まれます。

1. コード生成ツール：一般的なVonage API統合のコードスニペットを生成する機能を追加し（複数のプログラミング言語をサポート）、開発者がAPI機能を迅速に実装できるようにします。
2. APIパラメーターアシスタント：開発者が有効なAPIリクエストを構築できるよう支援するツールを開発し、パラメーターの提案、入力の検証、およびさまざまなVonage APIエンドポイントの必須およびオプションフィールドの説明を行います。
3. トラブルシューティングアシスタント：一般的な統合問題を診断する機能を実装し、エラーコードを分析し、知識ベースの記事とドキュメントに基づいて解決策を提供し、デバッグ時間を大幅に削減します。
4. ゲートウェイ構成アシスタント：VonageサービスのWebhookの設定とテストを支援するツールを作成し、開発者がWebhookコールバックをスムーズに構成できるようにします。
5. APIパフォーマンス最適化提案ツール：現在のAPI使用状況を分析し、パフォーマンスと効率を最適化するための提案を提供する機能を追加します。