ssh-mcp-rs 4.1.1

SeSSHion: lightweight SSH MCP server for LLM agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

//! SeSSHion - A lightweight SSH MCP server for LLM agents
//!
//! This crate provides an MCP server that allows executing commands on remote Linux
//! systems via SSH. It supports both password and key-based authentication, as well
//! as privilege elevation via `su` and `sudo`.
//!
//! # Features
//!
//! - Execute shell commands on remote SSH servers (`shell` tool)
//! - Support for `sudo` command execution with password (`sudo_shell` tool)
//! - Persistent SSH connection with auto-reconnect
//! - Configurable command timeout
//! - Command length limits for safety
//!
//! # MCP Tools
//!
//! - `shell` - Execute a shell command on the remote SSH server
//! - `sudo_shell` - Execute a command with sudo privileges (can be disabled with `--disable-sudo`)
//! - `check_process` - Monitor background command and transfer jobs
//! - `transfer` - Transfer files and directories over SSH, optionally in the background
//! - `apply_patch` - Create, update, or delete one remote UTF-8 text file
//! - `sudo_apply_patch` - Apply an exact remote file patch under sudo (can be disabled with `--disable-sudo`)
//!
//! # Example Usage (CLI)
//!
//! ```bash
//! ssh-mcp --host=192.168.1.100 --user=admin --password=secret
//! ```
//!
//! # Example Usage (MCP Inspector)
//!
//! ```bash
//! npx @modelcontextprotocol/inspector ./target/release/ssh-mcp -- \
//!   --host=YOUR_HOST --user=root --password=pass
//! ```

pub mod background;
pub mod config;
pub mod error;
pub mod logging;
pub(crate) mod patch;
#[cfg(unix)]
pub(crate) mod platform;
pub mod server;
mod shell_escape;
pub mod ssh;
pub mod tools;
pub mod transfer;
pub(crate) mod validate;

// Re-exports for convenience
pub use config::{Args, Config};
pub use error::{Result, SshMcpError};
pub use server::SshMcpServer;
pub use ssh::{
    CommandOutput, HostKeyCheckMode, SshConfig, SshConnectionManager, SshHandler,
    escape_command_for_shell, escape_for_shell, escape_for_timeout_wrapper, sanitize_command,
    sanitize_password, wrap_command_with_timeout, wrap_sudo_command,
};
pub use tools::{CheckProcessParams, ExecParams, SudoExecParams};