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
コメント