orion — MCP-сервер для Claude Code: REST и Kafka из JSON
MCP-сервер, через который агент собирает и правит декларативные REST- и Kafka-сервисы Orion: 58 инструментов над админским API.
claude mcp add --env ORION_SERVER_URL=<ORION_SERVER_URL> --env ORION_API_KEY=<ORION_API_KEY> --transport stdio orion -- docker run -i --rm -e ORION_SERVER_URL -e ORION_API_KEY ghcr.io/goplasmatic/orion-cli:1.1.0Что делает orion
Orion — это среда исполнения декларативных сервисов. Сервис описывается двумя сущностями: workflow с бизнес-логикой и channel, который принимает трафик. Публикуете определения, активируете — сервис работает, отдельный сервер приложений писать не нужно.
MCP-сервер даёт агенту доступ к админскому API Orion: 58 инструментов. Через них можно создать черновик workflow, прогнать его на тестовых данных, активировать, выкатить на часть трафика и откатить при проблеме. Определения пишет разработчик или предлагает ассистент, путь проверки у них один.
Сервер запускается в Docker и требует две переменные: ORION_SERVER_URL и ORION_API_KEY. Без ключа админские вызовы не пройдут. Orion рассчитан на работу в форме запросов и событий, которую можно выразить упорядоченными задачами и JSONLogic; для общего назначения и долгих процессов он не подходит. Ещё момент: каналы данных открыты, пока в них не объявлена аутентификация или пока инстанс не прикрыт прокси с проверкой подлинности — перед публикацией наружу пройдите чек-лист для продакшена.
Какие задачи решает
- собрать REST-эндпоинт из JSON-описания без написания сервера
- поднять Kafka-консьюмер и увести сбойные записи в dead-letter
- проверить черновик workflow на тестовом запросе до активации
- откатить версию сервиса, если после выката пошли ошибки
- подключить PostgreSQL или Redis через готовый коннектор
Примеры запросов агенту
- Создай черновик workflow для обработки заказов и покажи его перед активацией
- Прогони dry-run этого workflow на заказе с суммой 12500
- Выкати новую версию канала
POST /ordersна часть трафика
Как установить orion
Командой платформы
claude mcp add --env ORION_SERVER_URL=<ORION_SERVER_URL> --env ORION_API_KEY=<ORION_API_KEY> --transport stdio orion -- docker run -i --rm -e ORION_SERVER_URL -e ORION_API_KEY ghcr.io/goplasmatic/orion-cli:1.1.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add orion --env ORION_SERVER_URL=<ORION_SERVER_URL> --env ORION_API_KEY=<ORION_API_KEY> -- docker run -i --rm -e ORION_SERVER_URL -e ORION_API_KEY ghcr.io/goplasmatic/orion-cli:1.1.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"orion": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ORION_SERVER_URL",
"-e",
"ORION_API_KEY",
"ghcr.io/goplasmatic/orion-cli:1.1.0"
],
"env": {
"ORION_SERVER_URL": "<ORION_SERVER_URL>",
"ORION_API_KEY": "<ORION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"orion": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ORION_SERVER_URL",
"-e",
"ORION_API_KEY",
"ghcr.io/goplasmatic/orion-cli:1.1.0"
],
"env": {
"ORION_SERVER_URL": "<ORION_SERVER_URL>",
"ORION_API_KEY": "<ORION_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ORION_SERVER_URL=<ORION_SERVER_URL> -e ORION_API_KEY=<ORION_API_KEY> orion docker run -i --rm -e ORION_SERVER_URL -e ORION_API_KEY ghcr.io/goplasmatic/orion-cli:1.1.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о orion
Как установить orion в Claude Code?
Одной командой: `claude mcp add --env ORION_SERVER_URL=<ORION_SERVER_URL> --env ORION_API_KEY=<ORION_API_KEY> --transport stdio orion -- docker run -i --rm -e ORION_SERVER_URL -e ORION_API_KEY ghcr.io/goplasmatic/orion-cli:1.1.0`. Подставьте адрес своего инстанса Orion и ключ API.
Что делает orion?
Даёт агенту 58 инструментов над админским API Orion, чтобы создавать, тестировать, активировать и откатывать декларативные сервисы. Бизнес-логика при этом описывается в JSON, а маршрутизацию, лимиты и трассировку берёт на себя среда исполнения.
Что нужно для работы orion?
Запущенный инстанс Orion и ключ API — они передаются в ORION_SERVER_URL и ORION_API_KEY. Сам MCP-сервер стартует в контейнере ghcr.io/goplasmatic/orion-cli:1.1.0, поэтому нужен Docker.
