Avrotize — MCP-сервер для Claude Code: что делает и как установить
Транслирует схемы данных между Protobuf, Avro, JSON Schema и базами данных, а также создаёт типизированный код. Помогает подружить несовместимые контракты API.
claude mcp add avrotize -- uvx avrotizeЧто делает Avrotize
Сервер работает как промежуточный конвертер для структур данных. Avrotize транслирует спецификации в собственный формат Avrotize Schema на базе Apache Avro. Из этой промежуточной модели утилита создаёт целевые схемы или типизированные классы для Python, TypeScript, Rust и Go.
Инструмент считывает структуры таблиц из PostgreSQL, MySQL, BigQuery и документов MongoDB. Без установленных библиотек драйверов вроде avrotize[postgres] или avrotize[all-sql] прямое подключение к базам данных работать не будет.
Для запуска сервера через протокол MCP требуется Python 3.10 или новее. Это обязательное условие.
Какие задачи решает
- конвертировать схемы из JSON Schema или XSD в Protobuf
- сгенерировать классы данных для TypeScript, Go или Rust по файлу Avro
- выгрузить схему таблиц из базы данных PostgreSQL в универсальный формат
- преобразовать структуру сообщений Kafka Connect или Parquet в целевой формат
Примеры запросов агенту
- Сконвертируй спецификацию
order.jsonиз JSON Schema в формат Protobuf 3 - Сгенерируй модели на TypeScript по описанию схемы
user_event.avsc - Считай схему таблицы из базы PostgreSQL и переведи её в Avrotize Schema
Как установить Avrotize
Командой платформы
claude mcp add avrotize -- uvx avrotizeuvx запускает команду с именем пакета; если в README она другая — uvx --from avrotize <команда>
Командой платформы
codex mcp add avrotize -- uvx avrotizeuvx запускает команду с именем пакета; если в README она другая — uvx --from avrotize <команда>
Файл настроек
{
"mcpServers": {
"avrotize": {
"command": "uvx",
"args": [
"avrotize"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from avrotize <команда>
Файл настроек
{
"servers": {
"avrotize": {
"type": "stdio",
"command": "uvx",
"args": [
"avrotize"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from avrotize <команда>
Командой платформы
gemini mcp add avrotize uvx avrotizeuvx запускает команду с именем пакета; если в README она другая — uvx --from avrotize <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Avrotize
Как установить Avrotize в Claude Code?
Выполните команду claude mcp add avrotize -- uvx avrotize. Для запуска понадобится установленный в системе Python 3.10 или новее.
Что делает MCP-сервер Avrotize?
Он переводит схемы данных между форматами Avro, JSON Schema, Protobuf и Parquet. Инструмент также генерирует программный код и выгружает структуры из баз данных.
Нужны ли дополнительные библиотеки для работы с базами данных?
Да, для извлечения схем из SQL-баз требуются специальные пакеты драйверов. Например, для PostgreSQL нужно поставить avrotize[postgres], а для всех баз сразу — avrotize[all-sql].
