Advertise
MCP.so
Sign In

Remote Session MCP Server

@kayoch1n

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

kayoch1n

Submitted by

kayoch1n

About Remote Session MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to manage persistent SSH sessions and execute commands on remote servers.

#ssh#development

Remote Session MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "remote-session": {
      "command": "remote-session-mcp"
    }
  }
}

Remote Session MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Remote Session Mcp?

Remote Session Mcp is a Model Context Protocol (MCP) server that enables AI assistants to manage persistent SSH sessions and execute commands on remote servers. It uses invoke_shell() to maintain interactive shell sessions where state (working directory, environment variables) persists across commands, unlike single-command SSH tools.

How to use Remote Session Mcp?

Install the server via uv pip install -e . or pip install -e ., then run remote-session-mcp or python -m remote_session_mcp. Ensure your remote servers are configured in ~/.ssh/config. Integrate with Claude Code by adding a mcpServers entry in your project’s mcp.json. Use the provided tools: hosts, create, execute, close, sessions, upload, and download.

Key features of Remote Session Mcp

  • Persistent SSH sessions with state across commands
  • Automatic parsing of ~/.ssh/config for connection details
  • Supports key-based authentication, custom ports, and jump hosts
  • File upload and download capabilities
  • List hosts and active sessions
  • Configurable session timeout (default 1 hour)

Use cases of Remote Session Mcp

  • AI-driven deployment workflows (e.g., navigate, pull, install, restart)
  • Debugging and server management with multi-step commands
  • Maintaining context across commands without manual state passing
  • Automating configuration changes that depend on previous commands
  • Securely transferring files to and from remote servers

Frequently asked questions

1

How does Remote Session Mcp differ from single-command SSH tools?

It maintains persistent interactive shell sessions where state like working directory and environment variables persist across commands, enabling natural multi-step workflows without losing context.

2

What are the system requirements for using Remote Session Mcp?

The server requires Linux/POSIX and assumes the remote server supports interactive shell sessions. It relies on POSIX‑compatible commands like `pwd` and `echo $?`.

3

How does authentication work?

Authentication uses your `~/.ssh/config` settings, supporting key‑based authentication, custom ports, jump hosts, and all standard SSH options. No credentials need to be hardcoded.

4

Is there a session timeout?

Yes, sessions auto‑close after 1 hour of inactivity. This timeout can be configured in `~/.remote-session/config.json`.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise