Avrotize — Claude Code MCP server: what it does, how to install
Converts data contracts between JSON Schema, Protobuf, Avro, and database models while generating typed code. Useful for bridging mismatched APIs.
claude mcp add avrotize -- uvx avrotizeWhat Avrotize does
The server functions as an intermediate translator for contract definitions. Avrotize maps incoming specifications to an internal Avrotize Schema derived from Apache Avro. From there, it generates target schema definitions or typed classes for TypeScript, Go, Python, and Rust.
The tool handles dozens of input sources, including Parquet, XML Schema, FlatBuffers, and Protobuf. It can also inspect schemas directly from databases such as PostgreSQL, MySQL, BigQuery, and MongoDB.
Database inspection commands fail unless you install specific driver extras such as avrotize[postgres] beforehand. Python 3.10 is strictly required.
What it helps with
- convert JSON Schema or XML definitions into Protocol Buffers
- generate typed structures for TypeScript, Go, or Rust from schema files
- extract database table definitions from PostgreSQL into intermediate schemas
- transform Kafka Connect and Parquet schemas into Avro contracts
Example prompts for the agent
- Convert the
schema.jsonfile from JSON Schema to Protobuf 3 - Generate TypeScript interfaces based on the
events.avscAvro schema - Extract the PostgreSQL database schema and transform it into Avrotize Schema
How to install Avrotize
Platform CLI
claude mcp add avrotize -- uvx avrotizeuvx runs the command named after the package; if the README names another one, use uvx --from avrotize <command>
Platform CLI
codex mcp add avrotize -- uvx avrotizeuvx runs the command named after the package; if the README names another one, use uvx --from avrotize <command>
Config file
{
"mcpServers": {
"avrotize": {
"command": "uvx",
"args": [
"avrotize"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from avrotize <command>
Config file
{
"servers": {
"avrotize": {
"type": "stdio",
"command": "uvx",
"args": [
"avrotize"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from avrotize <command>
Platform CLI
gemini mcp add avrotize uvx avrotizeuvx runs the command named after the package; if the README names another one, use uvx --from avrotize <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Avrotize
How do I install Avrotize in Claude Code?
Run claude mcp add avrotize -- uvx avrotize in your terminal. You must have Python 3.10 or later installed on your system.
What does Avrotize do?
It translates data structure definitions between formats such as Avro, JSON Schema, Protobuf, and relational databases. It also produces typed code across multiple programming languages.
Are extra packages needed for database conversion?
Yes, inspecting SQL schemas requires optional driver extras. Install packages such as avrotize[postgres] or avrotize[all-sql] depending on your target database.
