🚀 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使用情况并提供建议以优化性能和效率。