specrun — MCP-сервер для Claude Code: что делает и как установить
Превращает спецификации OpenAPI 2.0 и 3.x в готовые инструменты MCP для вызова API прямо из чата.
claude mcp add specrun -- npx -y @pavelpiha/specrunЧто делает specrun
Сервер сканирует указанную папку с файлами .yaml или .json, создавая вызовы для каждого эндпоинта. Имена инструментов формируются автоматически в snake_case на базе operationId или пути и HTTP-метода. Ответы сервисов возвращаются агенту в виде структурированного JSON.
Авторизация настраивается через файл .env рядом со спецификациями по шаблонам вроде {API_NAME}_API_KEY или {API_NAME}_BEARER_TOKEN. При изменении переменных сервер подхватывает новые ключи на лету без перезапуска. Есть пакетный вызов specrun_batch для отправки серии запросов за один шаг.
Серверу строго требуется Node.js 22 или новее. На более старых версиях рантайма процесс завершится ошибкой.
Какие задачи решает
- преобразовать схемы OpenAPI и Swagger в вызываемые инструменты
- отправлять запросы к REST API из интерфейса агента
- управлять ключами доступа и базовыми URL через
.env - выполнять серию однотипных запросов через пакетный инструмент
Примеры запросов агенту
- Вызови cars_addCar и добавь запись о новой машине из файла cars.json
- Покажи параметры и схему ответа для инструмента github_get_user_repos
- Отправь пачку запросов через specrun_batch с параметрами из payload.json
Как установить specrun
Командой платформы
claude mcp add specrun -- npx -y @pavelpiha/specrunКомандой платформы
codex mcp add specrun -- npx -y @pavelpiha/specrunФайл настроек
{
"mcpServers": {
"specrun": {
"command": "npx",
"args": [
"-y",
"@pavelpiha/specrun"
]
}
}
}Файл настроек
{
"servers": {
"specrun": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pavelpiha/specrun"
]
}
}
}Командой платформы
gemini mcp add specrun npx -y @pavelpiha/specrunПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о specrun
Как установить specrun в Claude Code?
Выполните команду claude mcp add specrun -- npx -y @pavelpiha/specrun в терминале.
Какие форматы спецификаций поддерживает сервер?
Поддерживаются файлы OpenAPI 3.x и Swagger 2.0 с расширениями .json, .yaml и .yml.
Какие требования к окружению нужны для работы?
Обязательно наличие Node.js версии 22 или новее. Без актуальной версии рантайма пакет не запустится.
