fauxnix

fauxnix — MCP-сервер сообщества (автор — 20000419). Bash для агентов на Windows через перевод команд в PowerShell без WSL. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
20000419
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
windows
Языки
typescript

Уровень риска: high

Выполняет команды оболочки на Windows с правами пользователя (rm, kill, сеть, нативные программы).

Настройка клиентов

codex
{
    "code": "[mcp_servers.fauxnix]\ncommand = 'C:\\Program Files\\nodejs\\node.exe'\nargs = ['C:\\Users\\<you>\\AppData\\Roaming\\npm\\node_modules\\fauxnix-cli\\dist\\index.js', 'mcp']",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README; путь пользователя заменить",
    "verified": "docs"
}

Что умеет

fauxnix — слой трансляции bash → PowerShell для ИИ-агентов на Windows. Агент пишет привычный bash (ls -la | grep foo, find . -name '*.ts' | wc -l, kill -9 1234). fauxnix детерминированно переводит каждую команду в PowerShell, выполняет её нативно и возвращает вывод в стиле GNU/Linux: колонки ls -l, сообщения об ошибках как в bash, коды выхода coreutils, автоматическая обработка UTF-8 и GBK. Виртуальная машина и WSL не нужны, во время работы вызовов LLM нет.

По README (версия 2.2.0):

  • 109 команд: файловые операции (ls cp mv rm find du chmod diff и др.), текстовые фильтры (grep sed awk sort uniq cut tr), ввод-вывод (cat head tail wc tee base64 xargs), система (ps kill env date uname и др.), сеть (curl wget ping dig), архивы (tar gzip zip unzip);
  • синтаксис оболочки: конвейеры, &&, ||, перенаправления, переменные, массивы, подстановка $(...), нормализация путей (/d/foo → D:\foo);
  • неизвестные команды (git, node, npm, python, docker и т. п.) передаются системе как есть;
  • MCP-инструмент bash с сохранением состояния сессии: текущая папка, переменные окружения, cd -;
  • инструмент bash_batch: заранее компилирует все шаги и выполняет их одной сессией за один запрос;
  • то, что перевести нельзя, завершается понятной ошибкой, а не молча неверным результатом.

Покрытие проверено 1469 автотестами и сравнением с Git Bash: 269 из 270 случаев совпадают.

Кому подойдёт

  • Тем, кто запускает агентов на Windows, если Git Bash или WSL недоступны или нестабильны.
  • CI-раннерам и закрытым машинам, где проще один npm install -g, чем целый набор инструментов.
  • Тем, у кого агенты ошибаются в PowerShell: неверные кавычки, «не тот» curl, кракозябры из-за кодировок.

Если Git Bash у вас уже работает, авторы советуют оставить его. Другие серверы — в категории разработка.

Установка

Требуется Windows с PowerShell 5.1+ (встроен) и Node.js 22.20.0 или новее. Node 18 и 20 во второй версии не поддерживаются.

npm install -g fauxnix-cli
fauxnix install --claude     # or --codex / --opencode / --kimi / --qwen
fauxnix doctor               # verifies encoding, harness config, and MCP round-trip

Пакет в npm называется fauxnix-cli, а команда после установки — fauxnix. Попробовать без установки можно так: npx fauxnix-cli@latest "ls -la src | head -3".

Подключение к клиентам

Конфиги приведены дословно из README. Команда fauxnix install записывает такую же форму автоматически. Подробнее — в инструкции как подключить MCP.

claude mcp add fauxnix -- fauxnix mcp

В конфиге Codex замените имя пользователя в пути на своё. Для любого другого MCP-клиента сервер запускается по stdio командой fauxnix mcp. Имя инструмента меняется переменной FAUXNIX_TOOL_NAME.

Проверка

Команда fauxnix doctor проверяет кодировку, конфиг клиента и полный цикл MCP-запроса. Затем попросите агента выполнить ls -la — вывод должен прийти в формате GNU.

Примеры задач

Найди все .log старше 7 дней и покажи, сколько их.
Посчитай строки во всех .ts файлах проекта.

Риски

fauxnix выполняет команды оболочки на вашей машине с вашими правами: удаление файлов (rm, find -delete), завершение процессов (kill), сетевые запросы и любые нативные программы. Ошибка агента здесь означает реальные изменения на диске.

  • В неинтерактивном режиме codex exec вызовы MCP-инструментов по умолчанию отклоняются. README предлагает флаг --dangerously-bypass-approvals-and-sandbox, но безопаснее работать интерактивно и подтверждать вызовы.
  • Пользуйтесь подтверждением команд в клиенте и запускайте агента в рабочей папке проекта.
  • Известные отличия от GNU перечислены в README. Модель доверия, защита сети и завершение процессов описаны в SECURITY.md.

Частые вопросы

Работает ли fauxnix на Linux или macOS?

Нет, он нужен именно для Windows: там он переводит bash в PowerShell.

Использует ли он LLM для перевода?

Нет, перевод детерминированный и обходится без вызовов моделей.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники