Voitta MCP Gateway

You run a lightweight MCP gateway that exposes Voitta library capabilities through the Model Context Protocol, allowing you to access Voitta tools over both STDIO (local) and SSE/HTTP transports. This gateway handles the translation between MCP requests and Voitta functionality, making it easy to test, explore, and automate Voitta tools from MCP clients.

How to use

To connect with an MCP client, you can run the gateway locally and choose either STDIO or HTTP transport. For fast testing, start in HTTP mode to expose an HTTP endpoint that MCP clients can query. For iterative testing or integration in environments that prefer local processes, use STDIO to run the gateway directly from your IDE or a scripting environment.

Key actions you can perform after starting the gateway include listing available Voitta tools through the voitta://tools resource, and invoking individual tools like get_voitta_tool_info to inspect tool details. You can observe server logs in the console output to verify startup, tool registration, and tool execution.

How to install

Prerequisites you need before installing and running the gateway:

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

Step-by-step setup and run commands:

Additional configuration and notes

Configuration is read from a Voitta YAML configuration file. By default, the server looks for a Voitta YAML file at a specific path, but you can override this location by setting the CONFIG_PATH environment variable.

Usage tips for testing and inspection:

Tools and resources

The gateway automatically registers all Voitta tools. You can view the available tools through the voitta://tools resource. In addition, you can use the following dedicated MCP tools to get more information about Voitta tools.

Available tools

get_voitta_tool_info

Fetches detailed information about a specific Voitta tool, including parameters and descriptions.