Shell Exec — MCP-сервер для Claude Code: bash-команды и фоновые задачи
Даёт агенту два инструмента: запуск bash-команд и проверку статуса фоновых задач. Пригодится, когда нужно собрать проект, поискать по файлам или поднять сервер.
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio shell-exec -- npx -y shell-exec-mcpЧто делает Shell Exec
Shell Exec — MCP-сервер, который открывает агенту доступ к оболочке. Внутри два инструмента: execute запускает bash-команду с необязательным таймаутом и режимом фона, а get_job_status показывает, что происходит с уже запущенной фоновой задачей. Через execute проходят сборки вроде npm run build или make, файловые операции (find, grep, mv, mkdir -p, stat) и осмотр системы (df -h, ps aux, env).
Фоновый режим — то, ради чего сервер и стоит брать. Долгие процессы вроде dev-сервера или наблюдателя за файлами запускаются отдельно, а потом статус спрашивается по мере надобности, не блокируя диалог.
Запускается через npx -y shell-exec-mcp, так что нужен Node.js с npm. Учтите: агент получает выполнение произвольных команд в вашей оболочке, а не работу в песочнице. Для проектов с секретами в переменных окружения это повод сначала подумать о правах и изоляции.
Какие задачи решает
- собрать проект и забрать вывод сборки в диалог
- найти файлы по маске через
findиgrep - поднять dev-сервер в фоне и потом проверить его состояние
- посмотреть занятое место и запущенные процессы
- переместить или удалить файлы прямо из агента
Примеры запросов агенту
- Запусти
npm run buildи покажи, на чём упало - Стартуй
npm run devв фоне, потом проверь статус задачи - Найди через
grepвсе упоминанияTODOв папкеsrc
Как установить Shell Exec
Командой платформы
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio shell-exec -- npx -y shell-exec-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add shell-exec --env MCP_TRANSPORT=<MCP_TRANSPORT> -- npx -y shell-exec-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"shell-exec": {
"command": "npx",
"args": [
"-y",
"shell-exec-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"shell-exec": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"shell-exec-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> shell-exec npx -y shell-exec-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Shell Exec
Как установить Shell Exec в Claude Code?
Выполните claude mcp add shell-exec-mcp -- npx -y shell-exec-mcp. Если нужен транспорт, есть вариант с переменной: claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio shell-exec -- npx -y shell-exec-mcp.
Что делает Shell Exec?
Даёт агенту инструмент execute для bash-команд и get_job_status для проверки фоновых задач. Сборка, поиск по файлам, запуск серверов в фоне — всё через них.
Нужен ли Node.js для Shell Exec?
Да, сервер стартует через npx -y shell-exec-mcp, поэтому нужен Node.js с npm. Команды выполняются в вашей оболочке, изоляции нет.
