Vonage Assist

🚀 Vonage AI 代碼助手 MCP 服務器

Vonage AI 代碼助手 MCP 服務器是一款專門為開發者打造的工具，它能助力開發者將 Vonage API 功能集成到應用程序中。該服務器基於 FastMCP 構建，具備 AI 輔助功能，可讓開發者快速訪問 Vonage 官方文檔，高效查找與 Vonage 通信 API 相關的信息。

🚀 快速開始

運行服務器

要運行 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 官方文檔。
• 集成網絡搜索，可在 Vonage 開發者文檔特定域中執行定向搜索。
• 與 Claude 和其他支持 MCP 協議的 AI 助手兼容，允許 AI 系統直接使用 Vonage 文檔生成響應。

📦 安裝指南

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

💻 使用示例

基礎用法

使用 Vonage-Assist 工具查找關於如何在 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. 代碼生成工具：添加功能以生成常見 Vonage API 集成（如 SMS、語音、驗證、視頻）在多種編程語言中的示例代碼片段，幫助開發者快速實現 Vonage 功能，遵循正確的語法和最佳實踐。
2. API 參數助手：開發一個工具，幫助開發者構建有效的 API 請求，通過建議參數、驗證輸入並解釋不同 Vonage API 端點的必填與可選字段。
3. 故障排除助手：實現功能以診斷常見集成問題，通過分析錯誤代碼並基於知識庫文章和文檔提供可行解決方案，從而顯著減少調試時間。
4. 網關配置助手：創建一個工具，協助設置和測試 Vonage 服務的網關端點，指導開發者處理回調和事件。
5. 最佳實踐顧問：添加功能以提供與上下文相關的最佳實踐建議，幫助開發者在性能、安全性和彈性方面構建更穩健的應用程序。
6. 速率限制與定價估算器：提供工具以幫助開發者根據具體使用場景估算成本並理解速率限制。

🔧 技術細節

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

• FastMCP：用於 MCP 服務器框架
• httpx：用於異步 HTTP 請求
• BeautifulSoup：用於 HTML 解析和文本提取
• python-dotenv：用於環境變量管理

核心功能通過以下幾個關鍵函數實現：

• search_web()：執行針對 Google Serper 的 API 請求
• fetch_url()：從網頁中獲取並提取內容
• vonage_docs()：主要工具函數，負責協調搜索和內容檢索過程