MCP Gateway for Voitta

This MCP server provides a gateway to the Voitta library, allowing you to use Voitta's capabilities through the Model Context Protocol (MCP). It supports both STDIO and SSE transports.

Requirements

• Python 3.10+
• Dependencies listed in requirements.txt (including voitta)

Installation

1. Clone this repository
2. Install dependencies:

   pip install -r requirements.txt

Configuration

The server reads the Voitta configuration from a YAML file. By default, it looks for the file at /Users/gregory/g/projects/llm/roma/voitta-example/config/voitta.yaml, but you can specify a different path using the CONFIG_PATH environment variable.

The configuration file should follow the format expected by the Voitta library. Refer to the Voitta documentation for details on the configuration format.

Usage

Running with VSCode

You can run the server directly from VSCode using the provided launch configuration.

Running from the Command Line

Run the server using:

python server.py

For HTTP mode (SSE transport):

FASTMCP_HTTP=1 PORT=10000 python server.py

Testing with MCP Inspector

The MCP Inspector is a useful tool for testing and debugging MCP servers. Here's how to use it with the Voitta Gateway:

1. Start the MCP Inspector:

   npx @modelcontextprotocol/inspector

2. Open the inspector console at http://localhost:5173

3. For STDIO transport (recommended for testing), use one of these options:

   Option 1: Using python directly

   • Select "STDIO" as the Transport Type
   • Set the Command to: python (or python3 depending on your system)
   • Set the Arguments to: server.py

   Option 2: Using uv

   • Select "STDIO" as the Transport Type
   • Set the Command to: uv
   • Set the Arguments to: run --with fastmcp --with pyyaml --with voitta --with pydantic server.py

   Option 3: Using fastmcp with full paths

   • Select "STDIO" as the Transport Type
   • Set the Command to: /path/to/your/fastmcp (e.g., /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway/.venv/bin/fastmcp)
   • Set the Arguments to: run /full/path/to/server.py (e.g., run /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway/server.py)

   Option 4: Using cd and fastmcp

   • Select "STDIO" as the Transport Type
   • Set the Command to: bash (or your shell)
   • Set the Arguments to: -c "cd /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway && fastmcp run server.py"

4. Click "Connect" to establish a connection to the server

5. Once connected, you can:

   • View available tools under the "Tools" tab
   • Access the voitta://tools resource to see all Voitta tools
   • Test tools by providing input parameters and executing them
   • View the server logs in the console output

For HTTP/SSE transport:

1. Start the server in HTTP mode:

   FASTMCP_HTTP=1 PORT=10000 python server.py

2. In the MCP Inspector, select "SSE" as the Transport Type
3. Set the URL to: http://localhost:10000
4. Click "Connect"

Available Tools and Resources

The server automatically registers all tools provided by the Voitta library. You can get a list of available tools using the voitta://tools resource.

Additionally, the server provides the following MCP tools:

• get_voitta_tool_info: Get detailed information about a specific Voitta tool, including its parameters and descriptions.

Installation for LLM Assistants

Install for Claude

fastmcp install server.py --name "voitta-gateway"

Install for Cline

Follow the Cline documentation for installing MCP servers.