AI导哈

Vonage AI代码辅助工具

Vonage AI代码辅助工具是一个基于MCP协议的服务器，帮助开发者快速集成Vonage API功能，提供文档搜索和内容提取服务。

  • by micahman33
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 micahman33/VonageAICodeAssist

使用说明

Vonage AI代码辅助MCP服务器

概述

Vonage AI Code Assist是一款模型上下文协议（MCP）服务器，旨在帮助开发人员将Vonage API功能集成到其应用程序中。该服务器利用FastMCP提供对Vonage文档的人工智能辅助访问，使开发人员能够快速找到有关Vonage通信API的相关信息。

运作原理

Vonage Assist MCP服务器的操作如下：

  1. 文档搜索：服务器提供了一个名为“Vonage Assist”的专用工具，可以搜索Vonage的官方文档。

  2. Web搜索集成：使用Google Serper API，该工具在Vonage开发人员文档域内执行有针对性的搜索(developer.vonage.com/en/documentation).

  3. 内容提取：提交搜索查询时，服务器：

    • 制定特定于站点的搜索查询
    • 将查询发送到Google Serper API
    • 接收带有相关文档链接的搜索结果
    • 从这些链接获取内容
    • 将提取的文本内容返回给用户

  4. MCP工具集成：该服务器与支持MCP协议的Claude和其他AI助手兼容，允许这些AI系统在响应中直接使用Vonage文档。

设置和要求

通过Smithery安装

通过以下方式自动安装Vonage AI Code Assist for Claude Desktop 史密瑟里:

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

手动安装

要运行Vonage Assist MCP服务器：

  1. 确保已安装Python 3.13+。

  2. 设置所需的环境变量：

    • SERPER_API_KEY：Google Serper的API密钥（网络搜索需要）

  3. 安装依赖项：

    uv install

  4. 运行服务器：

    python main.py

用法

一旦运行，MCP服务器就会公开 Vonage-Assist 工具具有以下参数：

  • query：搜索查询（例如“号码验证”、“短信API”）
  • library：要搜索的文档库（“vonage”是目前唯一支持的选项）

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

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

技术实现

服务器是使用以下方式构建的：

  • MCP服务器框架的FastMCP
  • httpx用于异步HTTP请求
  • 用于HTML解析和文本提取的BeautifulSoup
  • 用于环境变量管理的python dotenv

核心功能通过几个关键功能实现：

  • search_web()：执行对Google Serper的API请求
  • fetch_url()：从网页中检索和提取内容
  • vonage_docs()：协调搜索和内容检索过程的主要工具功能

未来的考虑因素

Vonage Assist MCP服务器的主要潜在增强功能：

  1. 代码生成工具：添加功能，为多种编程语言的常见Vonage API集成（SMS、Voice、Verify、Video）生成示例代码片段，帮助开发人员使用正确的语法和最佳实践快速实现Vonage功能。

  2. API参数帮助程序：开发一个工具，通过建议参数、验证输入以及解释不同Vonage API端点的必需字段与可选字段，帮助开发人员构建有效的API请求。

  3. 故障排除助手：通过分析错误代码并根据知识库文章和文档提供可操作的解决方案，实现诊断常见集成问题的功能，从而显著缩短调试时间。

  4. Webhook配置助手：创建一个工具来帮助设置和测试Vonage服务的webhook端点，指导开发人员完成处理回调和事件的过程。

  5. 最佳实践顾问：在实现Vonage API时，添加一种功能，为性能、安全性和弹性提供特定于上下文的最佳实践，帮助开发人员构建更健壮的应用程序。

  6. 费率限制和定价估算器：帮助开发人员估算成本并了解其特定用例的费率限制。

相关 MCP