Vonageaicodeassist

🚀 Vonage AI Code Assistance MCP Server

The Vonage AI Code Assistance MCP Server is a developer - centric tool designed to facilitate the integration of Vonage API capabilities into applications. It leverages FastMCP to offer AI - assisted features, enabling developers to quickly access Vonage's official documentation and more efficiently find information related to Vonage's communication APIs.

🚀 Quick Start

✨ Features

• Document Search: The server provides a dedicated tool named "Vonage - Assist" for searching in Vonage's official documentation.
• Integrated Web Search: Through the Google Serper API, it can perform targeted searches within the specific domain of Vonage developer documentation (developer.vonage.com/en/documentation).
• Content Extraction: When a search query is submitted, the server generates a search request for the website, sends it to the Google Serper API, receives search results with relevant document links, fetches content from these links, and returns the extracted text content to the user.
• MCP Tool Integration: The server is compatible with Claude and other AI assistants supporting the MCP protocol, allowing these AI systems to directly use Vonage documentation to generate responses.

📦 Installation

To run the Vonage Assist MCP server, follow these steps:

1. Ensure that Python 3.13 or a higher version is installed.
2. Configure the required environment variables:
   • SERPER_API_KEY: Google Serper API key (required for web search).
3. Install dependencies:

   uv install
   

4. Start the server:

   python main.py
   

💻 Usage Examples

Basic Usage

After the server is running, the "Vonage - Assist" tool can be configured with the following parameters:

• query: Search query (e.g., "Number Verification", "SMS API").
• library: The document library to search (currently only "vonage" is supported).

Example of using the tool (through an MCP - compatible AI):

Use the Vonage - Assist tool to find information on how to implement two - factor authentication in the Vonage API.

📚 Documentation

How it Works

The workflow of the Vonage Assist MCP server is as follows:

1. Document Search: The server provides a dedicated tool named "Vonage - Assist" for searching in Vonage's official documentation.
2. Integrated Web Search: Through the Google Serper API, this tool can perform targeted searches within the specific domain of Vonage developer documentation (developer.vonage.com/en/documentation).
3. Content Extraction: When a search query is submitted, the server will:
   • Generate a website - specific search request based on the query.
   • Send the request to the Google Serper API.
   • Receive search results containing relevant document links.
   • Fetch content from these links.
   • Return the extracted text content to the user.
4. MCP Tool Integration: The server is compatible with Claude and other AI assistants supporting the MCP protocol, allowing these AI systems to directly use Vonage documentation to generate responses.

🔧 Technical Details

The server is built using the following technologies:

• FastMCP: For the MCP server framework.
• httpx: For asynchronous HTTP requests.
• BeautifulSoup: For HTML parsing and text extraction.
• python - dotenv: For environment variable management.

The core functions are implemented through several key functions:

• search_web(): Executes requests to the Google Serper API.
• fetch_url(): Retrieves and extracts web page content.
• vonage_docs(): The main tool function responsible for coordinating the search and content retrieval process.

Future Considerations

Potential improvements for the Vonage Assist MCP server:

1. Code Generation Tool: Add the ability to generate code snippets for common Vonage API integrations (e.g., SMS, Voice, Verify, Video) to help developers quickly implement API features and provide correct syntax and best practices.
2. API Parameter Assistant: Develop a tool to assist developers in constructing valid API requests by suggesting parameters, validating inputs, and explaining required and optional fields for different Vonage API endpoints.
3. Troubleshooting Assistant: Implement the ability to diagnose common integration issues by analyzing error codes and providing solutions based on knowledge - base articles and documentation, significantly reducing debugging time.
4. Gateway Configuration Tool: Create an auxiliary tool to help developers set up and test gateway endpoints for Vonage services and guide them through the callback and event - handling process.
5. Best Practices Advisor: Add a feature to provide best - practice recommendations for performance, security, and resilience based on the context, helping developers build more reliable applications.
6. Rate Limit and Pricing Estimator: Provide a tool to help developers estimate costs and understand Vonage's rate limits based on specific use cases.