local-shell-mcp
MCP-сервер дает ChatGPT и агентам терминал, файлы, Playwright и удаленные машины в изолированном рабочем каталоге.
- 106 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет произвольные команды и правит файлы, а сервер можно открыть в интернет через туннель.
Установка
- Работает в
Ручная установка
npx local-shell-mcp --helpПервая команда раздела Quick start запускает официальный лаунчер; для сервера дальше нужны `.env` и `docker compose up -d`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольные команды и правит файлы, а сервер можно открыть в интернет через туннель.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
local-shell-mcp открывает MCP-клиенту настоящую среду выполнения: оболочка с постоянными сессиями, файловые операции, поиск, патчи, Playwright и аудит. Git используется через обычный CLI. Есть длительные логические сессии с необязательным планом цели и публичные ссылки на файлы. Сервер запускается через Docker, расширение VS Code, бинарный файл, Python или stdio. К ChatGPT подключается по HTTPS с OAuth 2.1. Удаленные воркеры подключаются исходящим соединением, поэтому машины за NAT и брандмауэром тоже доступны. Дополнительно сервер читает `SKILL.md` через три фиксированных инструмента.
Для кого. Разработчикам и администраторам, которые хотят дать ChatGPT или другому MCP-клиенту рабочую оболочку на своем сервере или в контейнере.
Подходит, если
- ChatGPT в режиме разработчика должен запускать тесты и сборки на вашей машине.
- Агенту нужен постоянный терминал и правка файлов в одном рабочем каталоге.
- Нужно управлять лабораторной машиной за NAT через исходящее подключение.
- Задача идет несколько разговоров, и ее продолжают по номеру сессии.
Не подходит, если
- Сервер хотят запускать на личном компьютере с рабочими секретами без контейнера или виртуальной машины.
- Открывать доступ из интернета без OAuth недопустимо.
- Нужен только поиск по коду без выполнения команд.
Пример запроса к агенту
Запусти тесты проекта в рабочем каталоге, покажи падающие и поправь файл, не трогая остальное.MCP
- Транспорт
- http, stdio
- Авторизация
- OAuth
Переменные окружения
LOCAL_SHELL_MCP_PUBLIC_BASE_URLобязательная- Публичный HTTPS-адрес сервера.
LOCAL_SHELL_MCP_OAUTH_ADMIN_PINобязательная- PIN администратора для OAuth-входа.
LOCAL_SHELL_MCP_OAUTH_JWT_SECRETобязательная- Секрет подписи токенов OAuth.
Ограничения
Авторы называют границей безопасности контейнер или виртуальную машину, но не хост. Агент выполняет произвольные команды и правит файлы, поэтому запускать сервер на рабочей машине без изоляции опасно. Для публичного доступа нужен HTTPS-адрес, OAuth и надежный PIN администратора; туннель Cloudflare в составе compose требует токен. Расширение VS Code рекомендуют держать с выключенным `allowFullContainer` вне одноразовых контейнеров.
Как отключить. Остановите сервис (`docker compose down` или завершите процесс), удалите коннектор в ChatGPT или MCP-клиенте и закройте туннель. Каталог состояния, `.env` с токенами и журнал аудита удалите отдельно.
Частые вопросы
Чем запускать: Docker или бинарным файлом?
Оба варианта поддерживаются, вместе с VS Code, Python и stdio. README советует держать границу безопасности на уровне контейнера или виртуальной машины.
Как подключить ChatGPT?
Откройте сервер по HTTPS, оставьте OAuth включенным, добавьте адрес `https://your-public-host.example.com/mcp` и пройдите авторизацию.
Есть ли веб-интерфейс?
Да, панель на `http://127.0.0.1:8765/ui` и терминальный OpenTUI, который запускается командой `local-shell-mcp tui`.
Как вызвать инструмент из скрипта?
Командой `lsm call`, например `lsm call run_shell --json '{"command":"uname -a"}'`, с отдельным локальным токеном CLI.
Работает ли сервер с DeepSeek Harness?
Да, мост ставится как `dsh plugin --profile web add local-shell-mcp-dsh` при запущенном локально сервере.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыWebSSH-консоль для VPS с MCP-сервером: агент работает на нескольких серверах, а токены с ACL ограничивают инструменты и хосты.
Console Automation MCP открывает агенту локальные оболочки и SSH-сессии: ввод, чтение вывода, поиск ошибок и долгие процессы
MCP-сервер дает агенту общую с человеком консоль PowerShell 7: команды видны в окне, пароли и коды MFA вводят вручную.
SSH MCP Server (classfang) — команды на сервере по SSH
SSH MCP Server (classfang)
MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас
Терминал, окна и рабочий стол вашей машины в браузере, а MCP-сервер дает агентам читать чужие сессии и вводить команды
Самостоятельно размещаемый MCP-сервер для выполнения команд на удаленных серверах по SSH с токенами и ролями
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| local-shell-mcp (эта карточка) | нет | OAuth | 106 | |
| Desktop Commander MCP | нет | не нужна | 10 294 | работает на локальной машине пользователя; local-shell-mcp рассчитан на контейнер, OAuth для ChatGPT и удаленные воркеры |
| headless terminal | нет | 121 | дает терминальную сессию; здесь еще файлы, Playwright, аудит и логические сессии с планом |
Коротко о README
Репозиторий описывает ChatGPT-совместимую панель управления для оболочки, файлов, браузера и удаленных машин. Есть Docker Compose, бинарные релизы, расширение VS Code и документация на отдельном сайте.