# Shell Exec

Даёт агенту два инструмента: запуск bash-команд и проверку статуса фоновых задач. Пригодится, когда нужно собрать проект, поискать по файлам или поднять сервер.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: domdomegg
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/domdomegg/shell-exec-mcp
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/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. Учтите: агент получает выполнение произвольных команд в вашей оболочке, а не работу в песочнице. Для проектов с секретами в переменных окружения это повод сначала подумать о правах и изоляции.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MCP_TRANSPORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MCP_TRANSPORT=<MCP_TRANSPORT> --transport stdio shell-exec -- npx -y shell-exec-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add shell-exec --env MCP_TRANSPORT=<MCP_TRANSPORT> -- npx -y shell-exec-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shell-exec": {
            "command": "npx",
            "args": [
                "-y",
                "shell-exec-mcp"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "shell-exec": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "shell-exec-mcp"
            ],
            "env": {
                "MCP_TRANSPORT": "<MCP_TRANSPORT>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MCP_TRANSPORT=<MCP_TRANSPORT> shell-exec npx -y shell-exec-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- собрать проект и забрать вывод сборки в диалог
- найти файлы по маске через `find` и `grep`
- поднять dev-сервер в фоне и потом проверить его состояние
- посмотреть занятое место и запущенные процессы
- переместить или удалить файлы прямо из агента

## Примеры запросов агенту
- Запусти `npm run build` и покажи, на чём упало
- Стартуй `npm run dev` в фоне, потом проверь статус задачи
- Найди через `grep` все упоминания `TODO` в папке `src`

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md