archstone — MCP-сервер для Claude Code: что делает и как установить
Декларативный компилятор, который превращает бизнес-логику из YAML-манифестов и спецификаций OpenAPI в инструменты MCP без ручного написания интеграционного кода.
claude mcp add archstone -- npx -y @archstone/cliЧто делает archstone
Archstone преобразует декларативное описание возможностей на языке CDL (Capability Definition Language) в промежуточное представление IR. Связки (bindings) соединяют эти возможности с REST API или базой данных PostgreSQL, а встроенный сервер раздаёт их агентам по протоколу MCP через команду archstone serve. Если уже есть готовая спецификация OpenAPI или каталог Postgres, начальный манишест собирает утилита archstone init.
Архитектура отсекает лишние данные с обеих сторон. Поля бэкенда, не объявленные в манифесте, физически не попадут в контекст модели, а выдуманные агентом параметры блокируются до отправки в бизнес-систему. Встроенная команда archstone verify прогоняет сохранённые тестовые фикстуры против работающего сервиса и выявляет дрейф контрактов.
Для работы утилиты требуется Node 22+. Сборка артефактов и запуск через archstone build и archstone serve работают автономно: сетевые запросы, внешние аккаунты или платные ключи компилятору не нужны.
Какие задачи решает
- превратить документацию OpenAPI в готовые инструменты MCP
- скрыть внутренние поля API и базы данных от языковой модели
- отсечь некорректные параметры агента до обращения к бэкенду
- проверить сохранность схемы и дрейф API через фикстуры
Примеры запросов агенту
- Сгенерируй манифест Archstone из спецификации
openapi.yamlдля домена catalog - Скомпилируй и проверь манифесты в каталоге
manifestчерезarchstone apply - Запусти локальный сервер инструментов MCP из папки
manifestчерезarchstone serve
Как установить archstone
Командой платформы
claude mcp add archstone -- npx -y @archstone/cliКомандой платформы
codex mcp add archstone -- npx -y @archstone/cliФайл настроек
{
"mcpServers": {
"archstone": {
"command": "npx",
"args": [
"-y",
"@archstone/cli"
]
}
}
}Файл настроек
{
"servers": {
"archstone": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@archstone/cli"
]
}
}
}Командой платформы
gemini mcp add archstone npx -y @archstone/cliПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о archstone
Как установить archstone в Claude Code?
Выполните команду claude mcp add archstone -- npx -y @archstone/cli. Для запуска окружению требуется среда Node 22+.
Что делает archstone?
Инструмент компилирует манифесты возможностей и файлы привязок к бэкендам в промежуточное представление. Из него генерируются инструменты MCP со строгой изоляцией полей между моделью и целевой системой.
Нужен ли доступ в сеть или ключ API для работы?
Нет, команды archstone build и archstone serve полностью автономны. Они выполняются локально без обращений к сторонним сервисам и не требуют учётной записи.
