Vonageassist

🚀 Vonage AI Code Assist

Vonage AI Code Assist是一個基於模型上下文協議（MCP）構建的服務器，旨在助力開發者將Vonage API功能集成到他們的應用中。藉助FastMCP框架，該服務器為開發者提供AI輔助工具，方便他們快速訪問Vonage文檔，查找有關Vonage通信API的相關信息。

🚀 快速開始

Vonage AI Code Assist MCP服務器能幫助開發者高效集成Vonage API功能。以下是啟動服務器的步驟：

1. 確保安裝了Python 3.13或更高版本。
2. 設置所需的環境變量：
   • SERPER_API_KEY：Google Serper API密鑰（用於執行網頁搜索）
3. 安裝依賴項：

   uv install
   

4. 啟動服務器：

   python main.py
   

✨ 主要特性

• 文檔搜索：服務器配備名為“Vonage - Assist”的專用工具，可在Vonage官方文檔中進行搜索。
• 網頁搜索集成：藉助Google Serper API，該工具能對Vonage開發者文檔網站（developer.vonage.com/en/documentation）進行定向搜索。
• 內容提取：當用戶提交搜索請求時，服務器會根據查詢生成特定於站點的搜索請求，發送到Google Serper API，接收包含相關文檔鏈接的搜索結果，從這些鏈接中獲取內容，並將提取的文本內容返回給用戶。
• 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：搜索查詢（例如，“號碼驗證”、“短信API”）
• library：要搜索的文檔庫（目前僅支持“vonage”選項）

使用示例（通過MCP兼容AI）：

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

🔧 技術細節

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

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

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

• search_web()：執行API請求到Google Serper API
• fetch_url()：獲取並提取網頁內容
• vonage_docs()：主工具函數，協調搜索和內容檢索流程

📚 詳細文檔

Vonage AI Code Assist MCP服務器未來的潛在增強功能包括：

1. 代碼生成器工具：添加生成常見Vonage API集成代碼片段的功能（支持多種編程語言），幫助開發者快速實現API功能，同時遵循最佳實踐。
2. API參數助手：開發一個工具，幫助開發者構建有效的API請求，通過建議參數、驗證輸入並解釋不同Vonage API端點的必填與可選字段。
3. 故障排除助理：實現診斷常見集成問題的功能，通過分析錯誤代碼並基於知識庫文章和文檔提供解決方案，顯著減少調試時間。
4. 網關配置助手：創建一個工具，協助設置和測試Vonage服務的Webhooks，確保開發者能夠順利配置webhook回調。
5. API性能優化建議器：添加功能，分析當前API使用情況並提供建議以優化性能和效率。