MCP Voitta Gateway

🚀 Voitta Gated Gateway's MCP Server

This MCP server provides a gateway for the Voitta library, allowing you to use Voitta's features via the Model Context Protocol (MCP). It supports both STDIO and SSE transmission methods.

🚀 Quick Start

✨ Features

• Serves as a gateway for the Voitta library.
• Supports two transmission methods: STDIO and SSE.
• Automatically registers all tools provided by the Voitta library.

📦 Installation

Prerequisites

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

Steps

1. Clone this repository.
2. Install the dependencies:

pip install -r requirements.txt

💻 Usage Examples

Run in VSCode

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

Run from the command line

Run the server using the following command:

python server.py

For HTTP mode (SSE transmission):

FASTMCP_HTTP=1 PORT=10000 python server.py

Test with MCP Inspector

MCP Inspector is a useful tool for testing and debugging MCP servers. Here are the steps to use it with the Voitta gateway:

1. Start the MCP Inspector:

npx @modelcontextprotocol/inspector

2. Open the Inspector console in your browser at: http://localhost:5173

3. Choose one of the following three ways to connect:

Option 1: Use python directly

• Select "STDIO" as the transmission type.
• Set the command to: python (or python3 depending on your system).
• Set the parameters to: server.py

Option 2: Use uv

• Select "STDIO" as the transmission type.
• Set the command to: uv
• Set the parameters to: run --with fastmcp --with pyyaml --with voitta --with pydantic server.py

Option 3: Use fastmcp with the full path

• Select "STDIO" as the transmission 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 parameters to: run /full/path/to/server.py (e.g., run /Users/gregory/g/projects/llm/roma/mcp-voitta-gateway/server.py)

Option 4: Use cd and fastmcp

• Select "STDIO" as the transmission type.
• Set the command to: bash (or another shell)
• Set the parameters 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. After a successful connection, you can:

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

For HTTP/SSE transmission:

1. Start the server in HTTP mode using the following command:

FASTMCP_HTTP=1 PORT=10000 python server.py

2. Select "SSE" as the transmission type in the MCP Inspector.
3. Set the URL to: http://localhost:10000
4. Click "Connect"

📚 Documentation

Configuration

The server reads Voitta's 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 use the CONFIG_PATH environment variable to specify a different path.

The configuration file should follow the format expected by the Voitta library. For more details, refer to the Voitta documentation.

Available Tools and Resources

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

In addition, the server provides the following MCP tools:

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

Installation for LLM Assistants

Installation for Claude

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

Installation for Cline

Please refer to the Cline documentation to install the MCP server.