MMCPMarkets
FS

fryjustinc/ssh-mcp-sessions

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

18 stars 7 forks Качество 70 Тренд 22MIT
Repository Install

MCP-инструмент для управления постоянными ssh-соединениями с набором хостов, позволяющий удаленно разрабатывать, развертывать и собирать информацию.

Обзор

Сервер Model Context Protocol (MCP), который предоставляет клиентам LLM безопасный и постоянный доступ к удаленным машинам. ssh-mcp позволяет MCP-совместимым клиентам (таким как Claude Code, Cursor или пользовательские инспекторы MCP) управлять удаленными машинами через SSH. После регистрации хостов сервер поддерживает постоянные сеансы оболочки, которые сохраняют состояние среды между командами — идеально подходит для многоступенчатых рабочих процессов, длительных процессов или интерактивной диагностики. Сервер реализован в TypeScript поверх официального @modelcontextprotocol/sdk. - раскрывает функциональность с помощью стандартных определений инструментов MCP. - поддерживать сеансы оболочки живыми, сохраняя рабочий каталог, переменные среды и состояние процесса в нескольких командах. - управление мишенями SSH с помощью прочной конфигурации JSON (~/.ssh-mcp/hosts.json). - поддерживает пароли, приватные ключи и пересылку агентов SSH (fallback). - сеансы автоматически закрываются после длительного бездействия; команды помечаются и контролируются для завершения.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), который предоставляет клиентам LLM безопасный постоянный доступ к удаленным машинам.

Таблица содержимого

  1. Обзор
  2. Ключевые особенности 3 Архитектура 4.Установка
  3. Запуск сервера 6 Интеграция клиентов Клод Десктоп Клод Код
  • Кодекс
  • Курсор
  1. Конфигурация хоста
  • Хранилище хозяина
  • Добавление хостов
  • Список хостов
  • Редактирование хозяев
  • Удаление хостов 8.Управление сессиями
  • Начать сеанс
  • Сеансы листинга
  • Исполняющие команды Закрытие сессий
  1. Режимы аутентификации
  2. Тайм-ауты и обработка бездействия
  3. Структура директорий
  4. Использование инструментов MCP
  5. Испытание
  6. Устранение неполадок
  7. Рассмотрение вопросов безопасности
  8. Вклад 17 Лицензия

Обзор

T0 позволяет MCP-совместимым клиентам (таким как Claude Code, Cursor или пользовательские инспекторы MCP) управлять удаленными машинами через SSH. После регистрации хостов сервер поддерживает постоянные сеансы оболочки, которые сохраняют состояние среды между командами — идеально подходит для многоступенчатых рабочих процессов, длительных процессов или интерактивной диагностики.

Сервер реализован в TypeScript поверх официального @modelcontextprotocol/sdk.

Ключевые особенности

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

SSH MCP Server

A Model Context Protocol (MCP) server that gives LLM clients safe, persistent SSH access to remote machines.

Table of Contents

  1. Overview
  2. Key Features
  3. Architecture
  4. Installation
  5. Running the Server
  6. Client Integrations
  7. Host Configuration
  8. Session Management
  9. Authentication Modes
  10. Timeouts & Inactivity Handling
  11. Directory Structure
  12. Using the MCP Tools
  13. Testing
  14. Troubleshooting
  15. Security Considerations
  16. Contributing
  17. License

Overview

ssh-mcp lets MCP-compatible clients (such as Claude Code, Cursor, or custom MCP inspectors) control remote machines through SSH. Once hosts are registered, the server maintains persistent shell sessions that retain environment state between commands—ideal for multi-step workflows, long-running processes, or interactive diagnostics.

The server is implemented in TypeScript on top of the official @modelcontextprotocol/sdk.

Key Features

  • MCP-compliant: exposes functionality through standard MCP tool definitions.
  • Persistent sessions: keep shell sessions alive, preserving working directory, environment variables, and process state across multiple commands.
  • Stored host profiles: manage SSH targets through durable JSON configuration (~/.ssh-mcp/hosts.json).
  • Flexible authentication: supports passwords, private keys, and SSH agent forwarding (fallback).
  • Timeout & cleanup safeguards: sessions auto-close after prolonged inactivity; commands are marked and monitored for completion.
  • Structured listings: query active sessions and saved hosts directly from the MCP client.

Architecture

MCP Client ─┬─> add-host / edit-host / remove-host
            │
            ├─> list-hosts
            │
            ├─> start-session ─┬─> PersistentSession (ssh2 shell)
            │                  ├─> exec (reuses shell, captures stdout/stderr)
            │                  └─> close-session / auto-timeout
            │
            └─> list-sessions

Persistent configuration → ~/.ssh-mcp/hosts.json
Открыть полный README на GitHub

Установка

npx ssh-mcp-sessions
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "ssh-mcp": { "command": "npx", "args": [ "ssh-mcp-sessions" ] } } }