---
slug: "rfk-jr-gateway"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/voitta-ai/mcp-voitta-gateway@master/README.md"
repo: "https://github.com/voitta-ai/mcp-voitta-gateway"
source_file: "README.md"
branch: "master"
---
# 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:
   ```bash
   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](https://pypi.org/project/voitta/) 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:

```bash
python server.py
```

For HTTP mode (SSE transport):

```bash
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:
   ```bash
   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:
   ```bash
   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

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

### Install for Cline

Follow the Cline documentation for installing MCP servers.