varaprasadreddy9676 avatar

Remote Bridge

varaprasadreddy9676/remote-bridge

Gives Claude structured access to remote servers through SSH and rsync instead of making it freestyle shell commands every time. You configure the target host, deploy path, restart command, and log locations once in YAML, then the AI can call tools like sync_to_remote, deploy, diagnose_failure, and compare_targets without rediscovering basic facts about your infrastructure. Built in Rust as a native binary. Useful when you want an AI to debug or deploy against a real server with operational context instead of guessing where logs live or how services restart on every interaction.

GitHub stars
5
tools
8
transport
STDIO
last updated
Mar 22, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

sync_to_remotePush local code to the server from the same AI session

Push local code to the server from the same AI session

No parameter schema in public metadata yet.

run_remote_commandRun remote shell commands with bounded output

Run remote shell commands with bounded output

No parameter schema in public metadata yet.

preflight_checkGet runtime facts in one compact response

Get runtime facts in one compact response

No parameter schema in public metadata yet.

fetch_logsPull configured logs without rediscovering paths

Pull configured logs without rediscovering paths

No parameter schema in public metadata yet.

restart_serviceReuse the configured restart command safely

Reuse the configured restart command safely

No parameter schema in public metadata yet.

deployRun the standard remote deploy flow as one action

Run the standard remote deploy flow as one action

No parameter schema in public metadata yet.

diagnose_failureCollect and summarize failure context instead of streaming raw shell debugging

Collect and summarize failure context instead of streaming raw shell debugging

No parameter schema in public metadata yet.

compare_targetsCompare environments using both config and live runtime facts

Compare environments using both config and live runtime facts

No parameter schema in public metadata yet.

Sponsors

Readme

RemoteBridge 🌉

A safe, configurable MCP tool for giving AI agents reliable access to remote servers.

RemoteBridge is a Rust CLI and MCP server for AI-assisted remote workflows. It syncs local code with rsync, runs remote commands over SSH, gathers logs and diagnostics, compares environments, and exposes all of that through a compact tool surface your AI can use directly.

Use it when you want an AI agent in Claude Code, Cursor, Windsurf, Codex, or another MCP-enabled tool to work against a remote machine with real operational context, not just a shell prompt.

Instead of making the model guess how your server is set up, RemoteBridge gives it a configured operational interface.

What RemoteBridge Helps The AI Understand

When an AI is debugging or deploying on a remote machine, it needs more than "run this command".

It needs to understand things like:

  • where the app is deployed
  • how the service is restarted
  • which log files matter
  • what runtimes are installed
  • whether the service is healthy
  • which ports are listening
  • whether disk or memory pressure is involved
  • how staging differs from production
  • which commands are allowed or dangerous

View the full README on GitHub

Details

Repository
github.com/varaprasadreddy9676/remote-bridge
Package
remote-bridge-cli
Transport
STDIO
Registry
MCP registry, active

More from varaprasadreddy9676