Vonage AI Assist MCP Server

Name: Vonage AI Assist MCP Server
Author: micahman33

本地服务

github.com/micahman33开发工具051 周前更新

代码仓库

关于 Vonage AI Assist MCP Server

Vonage AI Assist MCP Server 为 Vonage API 开发者提供官方文档检索工具，通过定向搜索和页面内容提取，向兼容 MCP 的 AI 助手提供资料。

主要功能

01搜索 Vonage 官方文档
02提取文档页面文本
03支持 query 与 library 参数

适用场景

01查找 SMS API 用法
02检索双重身份验证资料

MCP 相关

作为 MCP 服务，它向兼容客户端提供 Vonage-Assist 工具，用于搜索 Vonage 开发者文档并返回提取的文本。

#vonage #ai-assistant #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "VonageAssist": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Vonage AI Code Assist MCP 服务

概述

Vonage AI Code Assist 是一个 Model Context Protocol（MCP）服务，旨在帮助开发者将 Vonage API 功能集成到自己的应用中。该服务利用 FastMCP 提供 AI 辅助的 Vonage 文档访问能力，让开发者能够快速查找有关 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 文档。

安装与要求

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Vonage AI Code Assist：

npx -y @smithery/cli install @micahman33/VonageAICodeAssist --client claude

手动安装

要运行 Vonage Assist MCP 服务：

确保已安装 Python 3.13+。
设置所需的环境变量：
- SERPER_API_KEY：Google Serper 的 API 密钥（网页搜索必需）
安装依赖项：
```
uv install
```
运行服务：
```
python main.py
```

使用方法

运行后，MCP 服务会公开 Vonage-Assist 工具，该工具具有以下参数：

query：搜索查询（例如，「number verification」「SMS API」）
library：要搜索的文档库（目前仅支持「vonage」）

工具使用示例（通过兼容 MCP 的 AI）：

Use the Vonage-Assist tool to find information about implementing two-factor authentication with Vonage APIs.

技术实现

该服务使用以下组件构建：

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）提供多种编程语言的示例代码片段，帮助开发者使用正确的语法和最佳实践，快速实现 Vonage 功能。
API 参数助手：开发一款工具，通过推荐参数、验证输入，并说明不同 Vonage API 端点的必填字段与可选字段，帮助开发者构造有效的 API 请求。
故障排查助手：实现诊断常见集成问题的功能，通过分析错误代码，并根据知识库文章和文档提供可执行的解决方案，大幅缩短调试时间。
Webhook 配置助手：创建一款工具，协助设置和测试 Vonage 服务的 webhook 端点，引导开发者完成处理回调和事件的流程。
最佳实践顾问：添加一项功能，在实施 Vonage API 时提供针对具体场景的性能、安全性和韧性最佳实践，帮助开发者构建更可靠的应用程序。
速率限制与定价估算器：帮助开发者估算成本，并了解其特定用例的速率限制。