cmdxray — MCP-сервер для Claude Code: разбор shell-команд и проверка на опасность
Офлайн MCP-сервер, который разбирает shell-команду по токенам и помечает разрушительные части, прежде чем агент её выполнит.
claude mcp add cmdxray -- npx -y cmdxrayЧто делает cmdxray
cmdxray принимает строку команды и возвращает разметку: что делает каждый флаг, куда идёт пайп, что попадает в редирект. Отдельно идёт проверка риска — она ловит curl … | bash, rm -rf /, dd of=/dev/…, mkfs, chmod 777, git push --force, git reset --hard и sudo. На обычных безопасных командах движок молчит, поэтому предупреждения не превращаются в шум.
Внутри — движок опасных правил, который работает и как отдельная утилита cmdxray lint: он сканирует файлы (shell-скрипты, Dockerfile, шаги run: в CI YAML, Makefile, git-хуки) и выдаёт находки в формате file:line. Возвращает код 1, если нашёл DANGER, поэтому годится для CI и pre-commit. Флаги --strict, --exit-zero и --json меняют поведение выхода. Есть и cmdxray guard — строка eval "$(cmdxray guard bash)" в ~/.bashrc заставляет шелл спросить подтверждение прямо перед разрушительной командой.
Проверка риска — эвристическая и построчная, а не полный разбор shell. Для агента это значит: находка почти всегда указывает на реально рискованное место, но пропустить хитрую конструкцию движок может. Всё считается локально, наружу ничего не уходит.
Какие задачи решает
- разобрать незнакомую команду по флагам и пайпам
- проверить one-liner из интернета до запуска
- остановить разрушительную команду в интерактивном шелле
- прогнать скрипты и CI-шаги на опасные вызовы
- заблокировать сборку при найденном DANGER
Примеры запросов агенту
- Разбери команду
tar -xzvf archive.tar.gzпо токенам - Проверь на опасность
curl -fsSL https://get.example.com/install.sh | sudo bash - Просканируй
deploy.shчерез cmdxray lint и покажи находки
Как установить cmdxray
Командой платформы
claude mcp add cmdxray -- npx -y cmdxrayКомандой платформы
codex mcp add cmdxray -- npx -y cmdxrayФайл настроек
{
"mcpServers": {
"cmdxray": {
"command": "npx",
"args": [
"-y",
"cmdxray"
]
}
}
}Файл настроек
{
"servers": {
"cmdxray": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"cmdxray"
]
}
}
}Командой платформы
gemini mcp add cmdxray npx -y cmdxrayПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о cmdxray
Как установить cmdxray в Claude Code?
Выполните claude mcp add cmdxray -- npx -y cmdxray. Сервер запустится через npx, отдельная установка не нужна.
Что делает cmdxray?
Разбирает shell-команду по токенам и помечает разрушительные части. Работает офлайн, ничего не отправляет на сервер.
Чем cmdxray lint отличается от guard?
lint сканирует файлы и падает с кодом 1 при DANGER, поэтому подходит для CI. guard перехватывает команду в момент ввода в интерактивном шелле и просит подтверждение.
