Skip to main content
Glama

mcp-remote-agent

MCP-Server für die Remote-Entwicklung mit KI-Agenten

Ermöglichen Sie KI-Agenten den Zugriff auf Remote-Linux-Server über das MCP-Protokoll und verbinden Sie lokale Entwicklungsumgebungen nahtlos mit Remote-Servern.

License: MIT Version

Chinesische Dokumentation


Zusammenfassung in einem Satz

Ermöglichen Sie KI-Agenten (wie WorkBuddy, Claude Desktop, Cursor) das direkte Lesen/Schreiben von Remote-Linux-Serverdateien und das Ausführen von Befehlen über MCP, um die lokale Entwicklung nahtlos mit Remote-Servern zu verbinden.

Analogie: VS Code Remote SSH ist für Menschen; mcp-remote-agent ist für KI.


Related MCP server: SSH MCP Server

Hauptfunktionen

Funktion

Beschreibung

Remote-Datei R/W

remote_read / remote_write / remote_stat

Remote-Suche

remote_glob Suche nach Dateien per Glob-Muster

Befehlsausführung

remote_bash für einfache Befehle, remote_script für mehrzeilige Skripte

Stapelverarbeitung

remote_batch bis zu 20 Operationen pro Anfrage

Asynchrone Ausführung

remote_exec_async + remote_task für lang laufende Aufgaben

Konfigurations-Hot-Reload

remote_config Remote-Konfiguration ohne Neustart ändern

Dynamische Verbindungen

Wechseln zwischen mehreren Servern ohne MCP-Neustart

Gesundheitsprüfung

Automatische Erkennung des Remote-Dienststatus

Kodierungsbehandlung

Automatische Base64-Kodierung von Sonderzeichen, Bereinigung von CRLF/BOM


Schnellstart

1. Repository klonen

git clone https://github.com/knownothing20/mcp-remote-agent.git
cd mcp-remote-agent

2. Abhängigkeiten installieren

npm install

3. Konfigurieren

cp mcp-remote-agent.example.json local/mcp-remote-agent.json
# Edit local/mcp-remote-agent.json, fill in all variables

Schlüsselvariablen:

Variable

Beschreibung

skillDir

Absoluter Pfad zum Installationsverzeichnis des Skills

mcpConfigPath

Pfad zur MCP-Konfigurationsdatei des Ziel-KI-Tools

remoteUrl

Adresse des Remote-Daemons

authToken

Client-Authentifizierungs-Token

4. Konfiguration synchronisieren

node sync.cjs

5. Remote-Daemon bereitstellen

# Create daemon directory on remote server
ssh USER@SERVER "mkdir -p /path/to/daemon"

# Upload server files to remote server
scp server/server.js server/mcp-remote-agent-manager.sh server/package.json USER@SERVER:/path/to/daemon/

# Upload generated .env config (created by sync.cjs in step 4)
scp local/server/.env USER@SERVER:/path/to/daemon/

# SSH to remote server
ssh USER@SERVER
cd /path/to/daemon
npm install
nohup bash mcp-remote-agent-manager.sh >> boot.log 2>&1 &

6. KI-Tool neu starten

Starten Sie nach dem Wirksamwerden der Konfiguration Ihr KI-Tool neu, um die MCP-Registrierung zu aktivieren.


Unterstützte KI-Tools

KI-Tool

MCP-Konfigurationspfad (Windows)

MCP-Konfigurationspfad (macOS/Linux)

WorkBuddy

C:\Users\<user>\.workbuddy\mcp.json

~/.workbuddy/mcp.json

Claude Desktop

C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

Cursor

<project>\.cursor\mcp.json

<project>/.cursor/mcp.json

Windsurf

C:\Users\<user>\.codeium\windsurf\mcp_config.json

~/.codeium/windsurf/mcp_config.json


Tool-Liste

Tool

Funktion

remote_health

Erreichbarkeit des Remote-Dienstes prüfen

remote_read

Remote-Datei lesen (ETag-Cache)

remote_write

Remote-Datei schreiben (automatische Bereinigung von CRLF/BOM)

remote_stat

Dateimetadaten abrufen

remote_glob

Suche nach Glob-Muster

remote_bash

Remote-Befehl ausführen

remote_script

Mehrzeiliges Skript ausführen

remote_batch

Stapelverarbeitung

remote_exec_async

Asynchrone Ausführung

remote_task

Asynchrone Aufgabe abfragen

remote_config

Konfigurations-Hot-Reload

remote_status

Verbindungsdiagnose

Für eine detaillierte Nutzung siehe SKILL.md


Verzeichnisstruktur

mcp-remote-agent/
├── SKILL.md                        # Complete documentation
├── README.md                       # This file (English)
├── README_CN.md                    # Chinese documentation
├── index.js                        # MCP server main program
├── package.json                    # Client dependencies
├── mcp-remote-agent.example.json   # Config template
├── sync.cjs                        # Variable sync script
├── test.cjs                        # Test script
├── .gitignore                      # Git ignore config
├── LICENSE                         # MIT License
├── CHANGELOG.md                    # Version changelog
├── local/                          # Local config directory
│   ├── README.md                   # Configuration guide
│   ├── mcp-remote-agent.json       # Main config (copy from example)
│   ├── connections.json.example    # Multi-server config example
│   └── server/
│       └── .env                    # Server config (auto-generated)
└── server/
    ├── server.js                   # Daemon process
    ├── mcp-remote-agent-manager.sh # Process guardian script
    ├── setup-autostart.sh          # Autostart config script
    ├── dashboard.html              # Web Dashboard UI
    ├── .env.example                # Server config template
    └── package.json                # Server dependencies

Konfigurationsdateien

Datei

Speicherort

Beschreibung

mcp-remote-agent.json

local/

Hauptkonfiguration (kopieren von mcp-remote-agent.example.json)

connections.json

local/

Multi-Server-Verbindungen (optional, siehe connections.json.example)

.env

server/

Serverkonfiguration (automatisch generiert durch sync.cjs)

Siehe local/README.md für eine detaillierte Konfigurationsanleitung.


Dashboard

mcp-remote-agent bietet ein Web-Dashboard zur Überwachung und Verwaltung:

Dashboard aktivieren

Einstellung in local/mcp-remote-agent.json:

{
  "variables": {
    "serverEnableDashboard": "true"
  }
}

Auf das Dashboard zugreifen

Besuchen Sie nach dem Start des Dienstes:

  • http://your-server:3183/

  • http://your-server:3183/dashboard

Dashboard-Funktionen

Funktion

Beschreibung

Dienststatus

Node.js, Abhängigkeiten, Port, Festplattenstatus anzeigen

Audit-Statistiken

Anforderungsstatistiken, Erfolgsrate, Analyse nach Typ/Client anzeigen

Fehlerprotokolle

Aktuelle Fehlerprotokolle anzeigen

Konfigurationsverwaltung

Serverkonfiguration anzeigen und ändern (erfordert Admin-Token)


Autostart-Konfiguration

Methode 1: Verwendung von setup-autostart.sh (Empfohlen)

# SSH to remote server
ssh USER@SERVER
cd /path/to/daemon

# Install autostart
bash setup-autostart.sh install

# Check status
bash setup-autostart.sh status

# Uninstall autostart
bash setup-autostart.sh uninstall

Methode 2: Manuelle crontab-Konfiguration

# Edit crontab
crontab -e

# Add the following line
@reboot /path/to/daemon/mcp-remote-agent-manager.sh # mcp-remote-agent autostart

Methode 3: Verwendung von systemd (Optional)

Erstellen Sie /etc/systemd/system/mcp-remote-agent.service:

[Unit]
Description=mcp-remote-agent daemon
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/path/to/daemon
ExecStart=/bin/bash /path/to/daemon/mcp-remote-agent-manager.sh
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Dann aktivieren:

sudo systemctl enable mcp-remote-agent
sudo systemctl start mcp-remote-agent

Sicherheitsfunktionen

  • Arbeitsbereich-Isolierung: Dateivorgänge auf WORKSPACE_ROOT beschränkt

  • Token-Authentifizierung: Client-Token + Admin-Token

  • Pfadbeschränkungen: Verhindern unbefugten Zugriff

  • Whitelist für Skript-Interpreter: Nur sichere Interpreter zulassen

  • Befehlsausführungsbeschränkungen: Konfigurierbare ALLOW_BASH_EXEC und ALLOWED_COMMANDS


Versionsgeschichte

Siehe CHANGELOG.md


Lizenz

MIT-Lizenz - Siehe LICENSE


Mitwirken

Fehlerberichte und Pull Requests sind willkommen!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An open MCP server that gives any AI agent SSH access to remote Linux/Unix machines — shell commands, file read/write, and SFTP transfers.
      11
      16 PyPI
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI tools to manage SSH connections, execute commands, transfer files, and perform remote server diagnostics via MCP protocol.
      17
      10 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compatible AI clients to remotely manage a Linux server via SSH, supporting file operations, Docker control, Git pulls, and arbitrary command execution.
      ISC