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, сеть, нативные программы).
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.