Vonageaicodeassist

🚀 Vonage AI 代碼輔助 MCP 服務器

Vonage AI 代碼輔助 MCP 服務器是為開發者量身打造的工具，能助力他們將 Vonage API 功能集成到應用程序中。該服務器藉助 FastMCP 提供 AI 輔助，讓開發者可快速訪問 Vonage 官方文檔，高效查找與 Vonage 通信 API 相關的信息。

🚀 快速開始

工作原理

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 文檔生成響應。

設置與要求

要運行 Vonage 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 中實現雙因素認證的信息。

✨ 主要特性

• 提供 AI 輔助功能，讓開發者能快速訪問 Vonage 官方文檔，高效查找相關信息。
• 集成網頁搜索，可在特定域進行針對性搜索。
• 與支持 MCP 協議的 AI 助手兼容，方便 AI 系統使用文檔生成響應。

📦 安裝指南

1. 確保已安裝 Python 3.13 或更高版本。
2. 配置環境變量 SERPER_API_KEY。
3. 執行 uv install 安裝依賴項。
4. 運行 python main.py 啟動服務器。

💻 使用示例

基礎用法

使用 Vonage - Assist 工具查找關於如何在 Vonage API 中實現雙因素認證的信息。

🔧 技術細節

服務器採用以下技術構建：

• 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 的速率限制。