开源MCP工具

Prerequisites

• Python 3.13+
• MCP CLI (mcp[cli]), FastAPI, httpx, pyjwt, python-dotenv, uvicorn, pydantic (see pyproject.toml for details)
• Vonage API credentials (API key, secret, application ID, private key)
• Public URL for callback server (for production use)

Setup

1. Install dependencies:

    pip install -r requirements.txt
    

    poetry install
    

2. Configure environment variables: - Create a .env file with your Vonage credentials:

      VONAGE_API_KEY=your_api_key
      VONAGE_API_SECRET=your_api_secret
      VONAGE_APPLICATION_ID=your_app_id
      VONAGE_PRIVATE_KEY_PATH=path/to/private.key
      VONAGE_LVN=your_virtual_number
      VONAGE_API_URL=https://api.nexmo.com/v1/calls
      VONAGE_SMS_URL=https://rest.nexmo.com/sms/json
      CALLBACK_SERVER_URL=https://your-public-url  # URL for Vonage event callbacks
      

3. Run the MCP server:

    python telephony_server.py
    

Running with Docker

You can also run the telephony MCP server using Docker:

1. Build and start the Docker container:

    docker compose up --build
    

    docker compose up --build -d
    

2. Stop the Docker container:

    docker compose down
    

3. View logs from the Docker container:

    docker compose logs -f
    

Demo Using Claude Desktop

<span style="color: green;">Demo Using GitHub Copilot</span>

<img src="./resources/demo-copilot.gif" alt="Telephony MCP Server Demo" style="border: 4px solid green; border-radius: 8px; display: block; margin-left: 0;"/>

Configuration

To use the callback server with Vonage Voice API, you need to set the CALLBACK_SERVER_URL environment variable to your server's public URL. This URL will be used as the event_url parameter in Vonage API calls.

export CALLBACK_SERVER_URL="https://your-public-url"

For local development, you can use a service like ngrok to expose your local server to the internet:

ngrok http 8080

Then set the CALLBACK_SERVER_URL to the ngrok URL.

Endpoints

• GET / - Health check endpoint
• POST /event - Main endpoint for receiving Vonage callbacks
• GET /events - List all stored events (with pagination)
• GET /events/{event_id} - Get a specific event by ID
• DELETE /events - Clear all stored events

LLMs and Tool Integration

LLMs (Large Language Models) are advanced token generators—they can generate text, images, or even video based on input prompts. However, their core capability is limited to generating content; they cannot access external data or perform actions in the real world on their own.

To extend their functionality, LLMs can be connected to external tools. For example, when a user asks, "What's the weather today?" the LLM can invoke a backend API tool like get_weather(city) via a system prompt, parse the response, and return the result to the user. This tool-calling mechanism transforms a basic LLM into a powerful LLM Application.