MCP.so
登录

Remote Session MCP Server

@kayoch1n

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

kayoch1n

提交者

kayoch1n

关于 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.

Remote Session MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

Remote Session MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

常见问题

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`.

评论

其他 分类下的更多 MCP 服务器