mcpField
A
A Better Mcp ssh Server

A Better Mcp ssh Server

Local
github.com/zhangyc310Developer Tools1Updated 47w ago
Repository

About A Better Mcp ssh Server

mcpssh is a Go-based MCP server for AI agents that need to manage interactive SSH sessions on remote servers. It provides persistent PTY sessions with tools for starting, interacting with, and closing them.

Key features

  1. 01Start SSH sessions with a PTY
  2. 02Send input and read session output
  3. 03Maintain persistent sessions
  4. 04Close sessions and release resources

Use cases

  1. 01Run commands on a remote server
  2. 02Respond to prompts in an interactive shell
  3. 03Execute scripts through an SSH session

MCP support

The MCP server exposes tools to start SSH sessions, interact with active sessions, and close them. Sessions are identified by a returned session ID.

#mcp#ssh#server#ai#automation

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Project Overview

mcpssh is a Go-based Model Context Protocol (MCP) server designed to facilitate SSH session management for AI agents. It enables an AI to interact with remote servers via SSH by creating persistent sessions, sending commands, and reading outputs through a pseudo-terminal (PTY) interface.

Architecture & Key Components

The project consists of a single main file mcpssh.go which defines the MCP server and its tools.

Core Tools
  • start_session: Initiates a new SSH connection to a specified host using a PTY. Returns a session_id.
  • interact_session: Sends input to and reads output from an active SSH session. This allows for interactive shell usage (e.g., handling prompts, running scripts).
  • close_session: Terminates an active SSH session and cleans up resources.
Dependencies
  • github.com/mark3labs/mcp-go: MCP server SDK.
  • github.com/creack/pty: PTY management for interactive SSH sessions.
  • github.com/google/uuid: Session ID generation.

Building and Running

Prerequisites
  • Go 1.25.0 or later.
  • ssh installed on system. I'm using it in macos.
  • ~/.ssh/config file
Build Command
go build -o mcpssh

Install

codex install use cmd args

codex mcp add mcpssh -- /your_path_to_mcpssh/mcpssh

gemini edit file ~/.gemini/settings.json
"mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    },
    "ssh": {
      "command": "/your_path_to_mcpssh/mcpssh",
      "args": []
    }
  },

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.