orionbelt-semantic-layer — MCP-сервер для Claude Code: что делает
MCP-сервер, который компилирует YAML-модели в SQL для BigQuery, Snowflake, DuckDB и ещё пяти диалектов. Агент описывает метрики и измерения один раз, потом задаёт вопросы на человеческом языке.
claude mcp add orionbelt-semantic-layer -- uvx orionbelt-semantic-layerЧто делает orionbelt-semantic-layer
Вы описываете измерения, меры и метрики в YAML — OrionBelt переводит их в диалект-специфичный SQL через AST. Поддерживает BigQuery, ClickHouse, Databricks, Dremio, DuckDB, MotherDuck, MySQL, PostgreSQL и Snowflake. Агент может отправить одноразовую модель и несколько запросов одним вызовом /v1/oneshot/batch: сервер проверит YAML, выполнит запросы и вернёт результаты с объяснениями и предупреждениями.
Сервер работает через PostgreSQL wire, Arrow Flight SQL, REST и MCP. Фиксированное зерно (grain: {mode: FIXED}) позволяет задать уровень агрегации для меры независимо от запроса — это становится OVER (PARTITION BY ...) в итоговом SQL.
Требует Python 3.12 или новее и uvx для установки. Лицензия BUSL-1.1.
Какие задачи решает
- Компилировать YAML-модель в SQL для девяти диалектов
- Задать фиксированное зерно агрегации для метрики
- Отправить несколько запросов с временной моделью одним вызовом
- Подключить BI-инструмент через PostgreSQL wire или Arrow Flight SQL
Примеры запросов агенту
- Скомпилируй YAML-модель
tpcds.obml.ymlи запросQ98.ymlв DuckDB SQL - Выполни запрос: выручка по странам и средний чек за февраль
- Загрузи модель
sales_model.obml.ymlи выведи список всех мер
Как установить orionbelt-semantic-layer
Командой платформы
claude mcp add orionbelt-semantic-layer -- uvx orionbelt-semantic-layeruvx запускает команду с именем пакета; если в README она другая — uvx --from orionbelt-semantic-layer <команда>
Командой платформы
codex mcp add orionbelt-semantic-layer -- uvx orionbelt-semantic-layeruvx запускает команду с именем пакета; если в README она другая — uvx --from orionbelt-semantic-layer <команда>
Файл настроек
{
"mcpServers": {
"orionbelt-semantic-layer": {
"command": "uvx",
"args": [
"orionbelt-semantic-layer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from orionbelt-semantic-layer <команда>
Файл настроек
{
"servers": {
"orionbelt-semantic-layer": {
"type": "stdio",
"command": "uvx",
"args": [
"orionbelt-semantic-layer"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from orionbelt-semantic-layer <команда>
Командой платформы
gemini mcp add orionbelt-semantic-layer uvx orionbelt-semantic-layeruvx запускает команду с именем пакета; если в README она другая — uvx --from orionbelt-semantic-layer <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о orionbelt-semantic-layer
Как установить orionbelt-semantic-layer в Claude Code?
Выполни claude mcp add orionbelt-semantic-layer -- uvx orionbelt-semantic-layer. Для Cursor добавь блок в конфиг MCP: "command": "uvx", "args": ["orionbelt-semantic-layer"].
Что делает orionbelt-semantic-layer?
Компилирует YAML-описания метрик и измерений в SQL для девяти диалектов. Агент описывает модель один раз, потом задаёт вопросы на человеческом языке — сервер переводит их в запросы к складу.
Какие базы данных поддерживает orionbelt-semantic-layer?
BigQuery, ClickHouse, Databricks, Dremio, DuckDB, MotherDuck, MySQL, PostgreSQL и Snowflake. Один YAML компилируется в любой из этих диалектов.
