remote-bridge — Claude Code MCP server: SSH deploy and sync
An MCP server that gives an AI agent access to a remote machine: code sync, deploy, logs and failure diagnosis.
claude mcp add remote-bridge -- npx -y remote-bridge-cliWhat remote-bridge does
RemoteBridge is a Rust CLI and MCP server. It pushes local code with rsync, runs commands on a remote host over SSH, pulls logs and diagnostics, and compares environments. Your agent calls all of it through a compact tool surface.
Recurring server facts live in remotebridge.yaml: the deploy path, the restart command, which log files matter, which commands are allowed or blocked. That means the agent stops rediscovering the same details on every run. The exposed tools are sync_to_remote, deploy, preflight_check, fetch_logs, diagnose_failure, compare_targets. Output is capped on purpose, so the model reads the useful tail instead of a full shell transcript.
Destructive commands can be confirmed, blocked, or limited to allowlisted prefixes. Without a configured remotebridge.yaml the tools have nothing to work from — no host, no path, no restart command. The server ships as the remote-bridge-cli package and runs through npx.
What it helps with
- push local edits to a remote server
- restart a service without hunting for the command
- collect logs and service state in one response
- diff staging against production
- keep dangerous commands behind an allowlist
Example prompts for the agent
- Sync my code to the server and deploy the latest build
- Pull the logs and tell me why the service died
- Compare staging and production runtimes
How to install remote-bridge
Platform CLI
claude mcp add remote-bridge -- npx -y remote-bridge-cliPlatform CLI
codex mcp add remote-bridge -- npx -y remote-bridge-cliConfig file
{
"mcpServers": {
"remote-bridge": {
"command": "npx",
"args": [
"-y",
"remote-bridge-cli"
]
}
}
}Config file
{
"servers": {
"remote-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"remote-bridge-cli"
]
}
}
}Platform CLI
gemini mcp add remote-bridge npx -y remote-bridge-cliStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about remote-bridge
How do I install remote-bridge in Claude Code?
Run claude mcp add remote-bridge -- npx -y remote-bridge-cli. That registers the server in your MCP config and starts it through npx.
What does remote-bridge do?
It gives an agent access to a remote machine: code sync, deploy, service restart, log collection and failure diagnosis, all as MCP tools.
What do I need to set up first?
A remotebridge.yaml file with the host, deploy path, restart command and log file list. Without it the tools have no target and no commands to run.
