Vonage AI Code Assist MCP Server

Vonage AI Code Assist MCP サーバー

概要

Vonage AI Code Assist は、開発者が Vonage API の機能をアプリケーションに統合できるよう支援する、Model Context Protocol（MCP）サーバーです。このサーバーは FastMCP を活用し、Vonage のドキュメントに AI を活用してアクセスできるようにすることで、Vonage の通信 API に関する関連情報をすばやく見つけられるようにします。

仕組み

Vonage Assist MCP サーバーは、次のように動作します。

1. ドキュメント検索：サーバーは、Vonage の公式ドキュメントを検索する「Vonage-Assist」という専用ツールを提供します。

2. ウェブ検索との連携：Google Serper API を使用して、Vonage 開発者向けドキュメントのドメイン（developer.vonage.com/en/documentation）に絞った検索を実行します。

3. コンテンツの抽出：検索クエリが送信されると、サーバーは次の処理を行います。

   • サイトに限定した検索クエリを作成します
   • Google Serper API にクエリを送信します
   • 関連するドキュメントへのリンクを含む検索結果を受け取ります
   • これらのリンク先のコンテンツを取得します
   • 抽出したテキストコンテンツをユーザーに返します

4. MCP ツールとの連携：このサーバーは、MCP プロトコルをサポートする Claude やその他の AI アシスタントと互換性があり、これらの AI システムが回答に Vonage のドキュメントを直接活用できます。

セットアップと要件

Smithery 経由でのインストール

Smithery 経由で Vonage AI Code Assist を Claude Desktop に自動インストールするには、次の手順を実行します。

npx -y @smithery/cli install @micahman33/VonageAICodeAssist --client claude

手動インストール

Vonage Assist MCP サーバーを実行するには、次の手順を実行します。

1. Python 3.13 以降がインストールされていることを確認します。

2. 必要な環境変数を設定します。

   • SERPER_API_KEY：Google Serper の API キー（ウェブ検索に必要）

3. 依存関係をインストールします。

   uv install
   

4. サーバーを実行します。

   python main.py
   

使用方法

実行すると、MCP サーバーは次のパラメーターを持つ Vonage-Assist ツールを公開します。

• query：検索クエリ（例：「number verification」、「SMS API」）
• library：検索対象のドキュメントライブラリ（現在サポートされているのは「vonage」のみです）

ツールの使用例（MCP 対応 AI 経由）：

Use the Vonage-Assist tool to find information about implementing two-factor authentication with Vonage APIs.

技術的な実装

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

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

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

• search_web()：Google Serper への API リクエストを実行します
• fetch_url()：ウェブページを取得し、コンテンツを抽出します
• vonage_docs()：検索とコンテンツ取得のプロセスを統括するメインツール関数です

今後の検討事項

Vonage Assist MCP サーバーで今後追加を検討している主な機能：

1. コード生成ツール：一般的な Vonage API 統合（SMS、Voice、Verify、Video）向けのサンプルコードスニペットを、複数のプログラミング言語で生成する機能を追加します。開発者が、適切な構文とベストプラクティスに基づいて Vonage の機能をすばやく実装できるようにします。

2. API パラメーター支援ツール：パラメーターの提案、入力の検証、さまざまな Vonage API エンドポイントで必須のフィールドと省略可能なフィールドの説明を通じて、開発者が有効な API リクエストを作成できるよう支援するツールを開発します。

3. トラブルシューティングアシスタント：エラーコードを分析し、ナレッジベースの記事やドキュメントに基づいて実行可能な解決策を提示することで、一般的な統合の問題を診断する機能を実装します。これにより、デバッグにかかる時間を大幅に短縮できます。

4. Webhook 設定支援ツール：Vonage サービス向けの Webhook エンドポイントの設定とテストを支援し、コールバックやイベントの処理手順を案内するツールを作成します。

5. ベストプラクティスアドバイザー：Vonage API の実装時に、パフォーマンス、セキュリティ、レジリエンスに関するコンテキストに応じたベストプラクティスを提供する機能を追加し、開発者がより堅牢なアプリケーションを構築できるよう支援します。

6. レート制限と料金の見積もりツール：開発者が具体的なユースケースに基づいてコストを見積もり、レート制限を把握できるよう支援します。