Vonageassist

🚀 Vonage AI Code Assist

Vonage AI Code Assist is a server built on the Model Context Protocol (MCP), designed to help developers integrate Vonage API capabilities into their applications. Leveraging the FastMCP framework, this server offers AI-assisted tools for developers to quickly access Vonage documentation and find relevant information about Vonage communication APIs.

🚀 Quick Start

How it Works

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

1. Document Search: The server provides a dedicated tool named "Vonage-Assist" for searching within the Vonage official documentation.
2. Web Search Integration: Through the Google Serper API, this tool can perform targeted searches on the Vonage developer documentation website (developer.vonage.com/en/documentation).
3. Content Extraction: When a user submits a search request, the server will:
   • Generate a site-specific search request based on the query.
   • Send the request to the Google Serper API.
   • Receive search results containing relevant documentation links.
   • Retrieve content from these links.
   • Return the extracted text content to the user.
4. MCP Tool Integration: This 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 and Requirements

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

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

   uv install
   

4. Start the server:

   python main.py
   

Usage

After the server is running, the Vonage-Assist tool will be exposed with the following parameters:

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

💻 Usage Examples

Basic Usage

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

🔧 Technical Details

Technologies Used

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.

Key Functions

The core functions are implemented through the following key functions:

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

🚀 Future Considerations

Potential future enhancements for the Vonage AI Code Assist MCP server include:

1. Code Generator Tool: Add the ability to generate common code snippets for Vonage API integrations (supporting multiple programming languages) to help developers quickly implement API features while adhering to best practices.
2. API Parameter Assistant: Develop a tool to assist developers in constructing effective API requests by suggesting parameters, validating inputs, and explaining the required and optional fields of different Vonage API endpoints.
3. Troubleshooting Assistant: Implement the function 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 Assistant: Create a tool to assist in setting up and testing webhooks for Vonage services, ensuring that developers can smoothly configure webhook callbacks.
5. API Performance Optimization Advisor: Add the function to analyze current API usage and provide suggestions to optimize performance and efficiency.