de en es ja ko ru zh

mcp-remote-agent

Name: mcp-remote-agent
Author: knownothing20

by knownothing20

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

mcp-remote-agent

Servidor MCP para el desarrollo remoto con agentes de IA

Permita que los agentes de IA operen servidores Linux remotos a través del protocolo MCP, conectando sin problemas los entornos de desarrollo locales con servidores remotos.

License: MIT Version

Documentación en chino

Resumen en una línea

Permita que los agentes de IA (como WorkBuddy, Claude Desktop, Cursor) lean/escriban directamente archivos de servidores Linux remotos y ejecuten comandos a través de MCP, conectando sin problemas el desarrollo local con servidores remotos.

Analogía: VS Code Remote SSH es para humanos; mcp-remote-agent es para IA.

Related MCP server: SSH MCP Server

Características principales

Característica	Descripción
Lectura/Escritura remota	`remote_read` / `remote_write` / `remote_stat`
Búsqueda remota	`remote_glob` busca archivos mediante patrones glob
Ejecución de comandos	`remote_bash` para comandos simples, `remote_script` para scripts multilínea
Operaciones por lotes	`remote_batch` hasta 20 operaciones por solicitud
Ejecución asíncrona	`remote_exec_async` + `remote_task` para tareas de larga duración
Recarga de configuración	`remote_config` modifica la configuración remota sin reiniciar
Conexiones dinámicas	Cambie entre múltiples servidores sin reiniciar MCP
Verificación de estado	Detección automática del estado del servicio remoto
Gestión de codificación	Codificación base64 automática de caracteres especiales, limpieza de CRLF/BOM

Inicio rápido

1. Clonar el repositorio

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

2. Instalar dependencias

npm install

3. Configurar

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

Variables clave:

Variable	Descripción
`skillDir`	Ruta absoluta al directorio de instalación de la habilidad
`mcpConfigPath`	Ruta al archivo de configuración MCP de la herramienta de IA de destino
`remoteUrl`	Dirección del demonio remoto
`authToken`	Token de autenticación del cliente

4. Sincronizar configuración

node sync.cjs

5. Desplegar demonio remoto

# 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. Reiniciar la herramienta de IA

Después de que la configuración surta efecto, reinicie su herramienta de IA para activar el registro MCP.

Herramientas de IA compatibles

Herramienta de IA	Ruta de configuración MCP (Windows)	Ruta de configuración MCP (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`

Lista de herramientas

Herramienta	Función
`remote_health`	Comprobar la accesibilidad del servicio remoto
`remote_read`	Leer archivo remoto (caché ETag)
`remote_write`	Escribir archivo remoto (limpieza automática de CRLF/BOM)
`remote_stat`	Obtener metadatos del archivo
`remote_glob`	Buscar por patrón glob
`remote_bash`	Ejecutar comando remoto
`remote_script`	Ejecutar script multilínea
`remote_batch`	Operaciones por lotes
`remote_exec_async`	Ejecución asíncrona
`remote_task`	Consultar tarea asíncrona
`remote_config`	Recarga de configuración
`remote_status`	Diagnóstico de conexión

Para un uso detallado, consulte SKILL.md

Estructura del directorio

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

Archivos de configuración

Archivo	Ubicación	Descripción
`mcp-remote-agent.json`	`local/`	Configuración principal (copiar desde `mcp-remote-agent.example.json`)
`connections.json`	`local/`	Conexiones a múltiples servidores (opcional, ver `connections.json.example`)
`.env`	`server/`	Configuración del servidor (generada automáticamente por `sync.cjs`)

Consulte local/README.md para obtener una guía de configuración detallada.

Panel de control

mcp-remote-agent proporciona un panel de control web para la supervisión y gestión:

Habilitar el panel de control

Establecer en local/mcp-remote-agent.json:

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

Acceder al panel de control

Después de iniciar el servicio, visite:

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

Características del panel de control

Característica	Descripción
Estado del servicio	Ver Node.js, dependencias, puerto, estado del disco
Estadísticas de auditoría	Ver estadísticas de solicitudes, tasa de éxito, análisis por tipo/cliente
Registros de errores	Ver registros de errores recientes
Gestión de configuración	Ver y modificar la configuración del servidor (requiere Token de administrador)

Configuración de inicio automático

Método 1: Usando setup-autostart.sh (Recomendado)

# 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

Método 2: Configuración manual de crontab

# Edit crontab
crontab -e

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

Método 3: Usando systemd (Opcional)

Cree /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

Luego habilite:

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

Características de seguridad

Aislamiento del espacio de trabajo: Operaciones de archivo restringidas dentro de WORKSPACE_ROOT
Autenticación por token: Token de cliente + token de administrador
Restricciones de ruta: Evitar el acceso no autorizado
Lista blanca de intérpretes de script: Solo permitir intérpretes seguros
Límites de ejecución de comandos: ALLOW_BASH_EXEC y ALLOWED_COMMANDS configurables

Historial de versiones

Consulte CHANGELOG.md

Licencia

Licencia MIT - Consulte LICENSE

Contribuciones

¡Los problemas y las solicitudes de extracción (Pull Requests) son bienvenidos!

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

Atako A
ai.atako
Remote MCP server to read and manage your Atako AI agents, messages, files, and integrations.
Agent Orchestration AI & Machine Learning
31
ClawLinkOAuth
dev.claw-link
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
App Automation Workplace & Productivity
24
termalin-web A
in.termal
Run commands and read/write files on your servers over Termalin's keyless tunnels (hosted MCP).
Shell Access File Systems
81
uldl
sh.uldl
Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.
File Systems Cloud Storage Agent Orchestration
2

Related MCP Servers

sshand
Shell Access Command Line File Systems
muradmalik23
A
license
A
quality
A
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.
Updated 3 months ago (2026-06-24 05:28 UTC)
11
MIT
SSH MCP Server
Shell Access Command Line
honwee
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.
Updated 6 months ago (2026-03-13 03:00 UTC)
17
4 npm
MIT
MCP SSH Server
Shell Access Command Line
Maxim11111
A
license
Not graded
quality
D
maintenance
A centralized MCP server that enables LLM agents to securely execute commands and manage Linux servers via SSH.
Updated 5 months ago (2026-04-12 21:24 UTC)
2
MIT
SSH MCP Server
Shell Access Command Line
fionarchl
A
license
Not graded
quality
C
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.
Updated 3 months ago (2026-06-27 16:15 UTC)
6,170 npm
MIT

Appeared in Searches

A server for Linux file operations

mcp-remote-agent

Resumen en una línea

Características principales

Inicio rápido

1. Clonar el repositorio

2. Instalar dependencias

3. Configurar

4. Sincronizar configuración

5. Desplegar demonio remoto

6. Reiniciar la herramienta de IA

Herramientas de IA compatibles

Lista de herramientas

Estructura del directorio

Archivos de configuración

Panel de control

Habilitar el panel de control

Acceder al panel de control

Características del panel de control

Configuración de inicio automático

Método 1: Usando setup-autostart.sh (Recomendado)

Método 2: Configuración manual de crontab

Método 3: Usando systemd (Opcional)

Características de seguridad

Historial de versiones

Licencia

Contribuciones

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

sshand

SSH MCP Server

MCP SSH Server

SSH MCP Server

Appeared in Searches