🚀 Vonage AI 代码辅助 MCP 服务器
Vonage AI 代码辅助 MCP 服务器是专门为开发者打造的工具，它能助力开发者将 Vonage API 功能集成到应用程序中。借助 FastMCP 提供的 AI 辅助功能，开发者可快速访问 Vonage 官方文档，高效查找与 Vonage 通信 API 相关的信息。
🚀 快速开始
要运行 Vonage Assist MCP 服务器，请按以下步骤操作：
- 确保已安装 Python 3.13 或更高版本。
- 配置所需的环境变量：
SERPER_API_KEY：Google Serper API 密钥（用于网页搜索，必需）
- 安装依赖项：
uv install - 启动服务器：
python main.py
✨ 主要特性
- 提供名为 "Vonage-Assist" 的专用工具，可在 Vonage 官方文档中进行搜索。
- 集成网页搜索，通过 Google Serper API 在特定域中执行针对性搜索。
- 能提取相关文档内容并返回给用户。
- 与 Claude 和其他支持 MCP 协议的 AI 助手兼容，允许 AI 系统直接使用 Vonage 文档生成响应。
📦 安装指南
- 确保已安装 Python 3.13 或更高版本。
- 配置所需的环境变量：
SERPER_API_KEY：Google Serper API 密钥（用于网页搜索，必需）
- 安装依赖项：
uv install - 启动服务器：
python main.py
💻 使用示例
基础用法
服务器运行后，"Vonage-Assist" 工具可通过以下参数进行配置：
query：搜索查询（例如 "号码验证"、"SMS API"）library：要搜索的文档库（目前仅支持 "vonage"）
示例工具使用（通过 MCP 兼容的 AI）：
使用 Vonage-Assist 工具查找关于如何在 Vonage API 中实现双因素认证的信息。
🔧 技术细节
工作原理
Vonage Assist MCP 服务器的工作流程如下：
- 文档搜索：服务器提供了一个名为 "Vonage-Assist" 的专用工具，用于在 Vonage 的官方文档中进行搜索。
- 网页搜索集成：通过 Google Serper API，该工具可以在 Vonage 开发者文档的特定域 (
developer.vonage.com/en/documentation) 中执行针对性搜索。 - 内容提取：当提交一个搜索查询时，服务器会：
- 根据查询生成一个针对网站的搜索请求
- 将请求发送到 Google Serper API
- 收取包含相关文档链接的搜索结果
- 从这些链接中获取内容
- 将提取的文本内容返回给用户
- MCP 工具集成：服务器与 Claude 和其他支持 MCP 协议的 AI 助手兼容，允许这些 AI 系统直接使用 Vonage 文档生成响应。
技术实现
服务器采用以下技术构建：
- FastMCP：用于 MCP 服务器框架
- httpx：用于异步 HTTP 请求
- BeautifulSoup：用于 HTML 解析和文本提取
- python-dotenv：用于环境变量管理
核心功能通过几个关键函数实现：
search_web()：执行 Google Serper API 的请求fetch_url()：获取并提取网页内容vonage_docs()：主要工具函数，负责协调搜索和内容检索过程
📚 详细文档
未来发展考虑
Vonage Assist MCP 服务器的潜在改进方向：
- 代码生成工具：添加生成常见 Vonage API 集成代码片段的功能（如 SMS、Voice、Verify、Video），帮助开发者快速实现 API 功能，并提供正确的语法和最佳实践。
- API 参数助手：开发一个工具，帮助开发者构造有效的 API 请求，通过建议参数、验证输入并解释不同 Vonage API 端点的必填与可选字段。
- 故障排除助手：实现诊断常见集成问题的功能，通过分析错误代码并基于知识库文章和文档提供解决方案，从而显著减少调试时间。
- 网关配置工具：创建一个辅助工具，帮助开发者设置和测试 Vonage 服务的网关端点，指导其完成回调和事件处理的过程。
- 最佳实践顾问：添加一种功能，根据上下文提供性能、安全性和弹性的最佳实践建议，帮助开发者构建更可靠的应用程序。
- 速率限制与定价估算器：提供一个工具，帮助开发者根据具体用例估算成本并了解 Vonage 的速率限制。