home / mcp / avrotize mcp server

Avrotize MCP Server

Serves as a local MCP server that exposes Avrotize’s schema conversion tools via standard MCP endpoints.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "clemensv-avrotize": {
      "command": "avrotize",
      "args": [
        "mcp"
      ]
    }
  }
}

Avrotize can run as a local MCP server, exposing its schema conversion tools over standard input/output. This enables you to integrate Avrotize’s capabilities into MCP clients for on-the-fly schema work and automated pipelines.

How to use

You run the Avrotize MCP server locally and connect to it from your MCP client. The server exposes conversion capabilities and a small set of control commands to describe, list, inspect, and execute conversions. Use the MCP client to discover available conversions, run a conversion, and retrieve results or error messages. This setup is ideal for integrating Avrotize into automated data pipelines, schema registries, or editor tooling that relies on a consistent MVC for schema transformations.

How to install

Prerequisites You need Python 3.10 or later installed on your system. Ensure you have a working Python environment and access to the internet for package installation.

Step 1: Install Avrotize with the MCP extra to enable MCP server support.

pip install "avrotize[mcp]"

Step 2: Start the MCP server locally

Run the MCP server for Avrotize using the local command shown.

avrotize mcp

Step 3: Optional publishing to the official MCP Registry

If you plan to publish the server configuration to the MCP Registry, you can validate and publish using the provided tools (these steps assume you have the necessary registry access and credentials):

mcp-publisher validate server.json
mcp-publisher publish server.json

Available tools

describe_capabilities

Describe server capabilities and available routes so clients can discover what conversions and commands are supported.

list_conversions

List the conversion commands available on the server.

get_conversion

Inspect a specific conversion command to understand its inputs, outputs, and behavior.

run_conversion

Execute a conversion using a specified command and input parameters, returning the result or errors.