1Shell MCP
WebSSH-консоль для VPS с MCP-сервером: агент работает на нескольких серверах, а токены с ACL ограничивают инструменты и хосты.
- 133 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент выполняет команды и скрипты на ваших серверах, а токен без ACL открывает все хосты.
- Удаленный MCP, выставленный наружу, дает доступ к серверам любому, кто завладел токеном.
- Журналы и вывод команд с серверов попадают в контекст модели.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/weidu12123/1Shell/main/install.sh | bashСтавит 1Shell на локальную машину или сервер; есть `bash install.sh --docker`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет команды и скрипты на ваших серверах, а токен без ACL открывает все хосты.
- Удаленный MCP, выставленный наружу, дает доступ к серверам любому, кто завладел токеном.
- Журналы и вывод команд с серверов попадают в контекст модели.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
1Shell — локальная платформа управления несколькими VPS: WebSSH-терминал для человека и MCP-сервер для агента. Claude Code, Codex, OpenCode и Hermes подключаются по `http://localhost:3301/mcp/sse` с заголовком `X-Bridge-Token` или через `bin/1shell-mcp-stdio.js`. Внутри есть собственный агент 1Shell AI с циклом AgentRun, скиллы в `data/skills` и мониторинг через SSH-зонды. Доступ ограничивают токены с ACL: список инструментов, хостов, скриптов и путей. Ключевые команды и вызовы MCP попадают в журнал аудита. Удаленный MCP по умолчанию выключен, его включают явно и выставляют через HTTPS.
Для кого. Администраторам нескольких VPS и разработчикам, которые поручают агенту рутину на серверах под контролем токенов и журнала.
Подходит, если
- Агент проверяет состояние нескольких серверов одним запросом.
- Скрипт обслуживания запускается на выбранных хостах с записью в журнал.
- Внешний агент подключается к серверам через удаленный MCP с токеном и ACL.
- Нужны одновременно веб-терминал для человека и API для агента.
Не подходит, если
- На серверах хранятся данные, где агенту нельзя выполнять команды.
- Нет возможности закрыть доступ HTTPS и токенами.
- Достаточно одного SSH-сервера без панели.
Пример запроса к агенту
Проверь нагрузку и свободное место на моих VPS через 1Shell и покажи хосты, где диск заполнен больше чем на 80 процентов.MCP
- Транспорт
- sse, stdio
- Авторизация
- ключ необязателен
Переменные окружения
BRIDGE_TOKENсекрет- Токен для локального доступа агента; пустое значение создает его при первом запуске.
Ограничения
Документация на китайском. Первая команда установки запускает `install.sh` с GitHub через `curl | bash`: прочитайте скрипт до запуска. Токен без ограничений ACL открывает агенту все хосты, настройте их до подключения. Удаленный MCP по умолчанию выключен, при включении публикуйте его только по HTTPS. В режиме Docker каталоги хоста монтируются, по умолчанию только для чтения: проверьте режим монтирования до запуска.
Как отключить. Удалите запись `1shell` из конфигурации агента, отзовите Bridge Token и Remote MCP Token в панели и остановите службу.
Частые вопросы
Как подключить агента локально?
Укажите `http://localhost:3301/mcp/sse` и заголовок `X-Bridge-Token` со своим Bridge Token. Есть также `bin/1shell-mcp-stdio.js` для stdio.
Как ограничить агента?
Выдайте токен с ACL: он задает инструменты, хосты, скрипты и пути, которые доступны агенту.
Включен ли удаленный MCP?
Нет, по умолчанию он выключен. Включайте его явно, создавайте Remote MCP Token и публикуйте через HTTPS.
Где найти Bridge Token?
Если `BRIDGE_TOKEN` пуст, токен создается при первом запуске и сохраняется в `data/bridge-token.json`.
Ведется ли журнал действий?
Да. В аудит попадают ключевые команды, запуск скриптов, вызовы Bridge и MCP и опасные операции.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP SSH Manager
mcp-ssh-manager
Управление несколькими SSH-подключениями из Claude Code и Codex: команды, перенос файлов, базы данных и бэкапы. Стабильная ветка в npm, в GitHub бета 4.0
SSH MCP Server (classfang) — команды на сервере по SSH
SSH MCP Server (classfang)
MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас
Самостоятельно размещаемый MCP-сервер для выполнения команд на удаленных серверах по SSH с токенами и ролями
SSH MCP
ssh-mcp
SSH-сервер с упором на безопасность: классификация команд, авторизация по политикам и разные способы входа. Выполняет команды на удаленных серверах
Защищенный MCP-рантайм, через который агент управляет локальными машинами, серверами и контейнерами
MCP-сервер из SSH-менеджера purple: агент читает хосты из ~/.ssh/config и контейнеры на них, а команды и управление контейнерами включаются отдельно
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| 1Shell (эта карточка) | нет | ключ необязателен | 133 | |
| SSH MCP Server | нет | API-ключ | 2 | дает агенту SSH-доступ к машинам; 1Shell добавляет веб-консоль, мониторинг и токены с ACL |
| MCP SSH Manager | нет | API-ключ | 534 | управляет SSH-подключениями через MCP; 1Shell объединяет их с панелью и внутренним агентом |
Коротко о README
Платформа объединяет WebSSH, мониторинг, скиллы, внутреннего агента 1Shell AI и MCP-сервер. Журнал аудита покрывает действия человека и агента.