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

MCP-сервер для удаленной разработки с помощью ИИ-агентов

Позволяет ИИ-агентам управлять удаленными Linux-серверами через протокол MCP, обеспечивая бесшовное соединение локальных сред разработки с удаленными серверами.

中文文档

Краткий обзор

Позволяет ИИ-агентам (таким как WorkBuddy, Claude Desktop, Cursor) напрямую читать/записывать файлы на удаленном Linux-сервере и выполнять команды через MCP, бесшовно связывая локальную разработку с удаленными серверами.

Аналогия: VS Code Remote SSH предназначен для людей; mcp-remote-agent — для ИИ.

Related MCP server: SSH MCP Server

Основные возможности

Функция	Описание
Удаленное чтение/запись файлов	`remote_read` / `remote_write` / `remote_stat`
Удаленный поиск	`remote_glob` поиск файлов по glob-шаблону
Выполнение команд	`remote_bash` для простых команд, `remote_script` для многострочных скриптов
Пакетные операции	`remote_batch` до 20 операций за запрос
Асинхронное выполнение	`remote_exec_async` + `remote_task` для длительных задач
Горячая перезагрузка конфига	`remote_config` изменение удаленного конфига без перезапуска
Динамические соединения	Переключение между несколькими серверами без перезапуска MCP
Проверка работоспособности	Автоматическое определение статуса удаленной службы
Обработка кодировки	Автоматическое base64-кодирование спецсимволов, очистка CRLF/BOM

Быстрый старт

1. Клонируйте репозиторий

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

2. Установите зависимости

npm install

3. Настройте

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

Ключевые переменные:

Переменная	Описание
`skillDir`	Абсолютный путь к каталогу установки навыков
`mcpConfigPath`	Путь к файлу конфигурации MCP целевого ИИ-инструмента
`remoteUrl`	Адрес удаленного демона
`authToken`	Токен аутентификации клиента

4. Синхронизируйте конфигурацию

node sync.cjs

5. Разверните удаленный демон

# 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. Перезапустите ИИ-инструмент

После вступления конфигурации в силу перезапустите ИИ-инструмент для активации регистрации MCP.

Поддерживаемые ИИ-инструменты

ИИ-инструмент	Путь к конфигу MCP (Windows)	Путь к конфигу 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`

Список инструментов

Инструмент	Функция
`remote_health`	Проверка доступности удаленной службы
`remote_read`	Чтение удаленного файла (кэш ETag)
`remote_write`	Запись удаленного файла (автоочистка CRLF/BOM)
`remote_stat`	Получение метаданных файла
`remote_glob`	Поиск по glob-шаблону
`remote_bash`	Выполнение удаленной команды
`remote_script`	Выполнение многострочного скрипта
`remote_batch`	Пакетные операции
`remote_exec_async`	Асинхронное выполнение
`remote_task`	Запрос асинхронной задачи
`remote_config`	Горячая перезагрузка конфига
`remote_status`	Диагностика соединения

Подробности использования см. в SKILL.md

Структура каталогов

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

Файлы конфигурации

Файл	Расположение	Описание
`mcp-remote-agent.json`	`local/`	Основная конфигурация (скопируйте из `mcp-remote-agent.example.json`)
`connections.json`	`local/`	Соединения с несколькими серверами (опционально, см. `connections.json.example`)
`.env`	`server/`	Конфигурация сервера (автоматически генерируется `sync.cjs`)

См. local/README.md для подробного руководства по настройке.

Панель управления

mcp-remote-agent предоставляет веб-панель для мониторинга и управления:

Включение панели управления

Установите в local/mcp-remote-agent.json:

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

Доступ к панели управления

После запуска службы перейдите по адресу:

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

Функции панели управления

Функция	Описание
Статус службы	Просмотр Node.js, зависимостей, порта, статуса диска
Статистика аудита	Просмотр статистики запросов, процента успеха, анализ по типам/клиентам
Журналы ошибок	Просмотр последних журналов ошибок
Управление конфигурацией	Просмотр и изменение конфигурации сервера (требуется токен администратора)

Настройка автозапуска

Способ 1: Использование setup-autostart.sh (рекомендуется)

# 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

Способ 2: Ручная настройка crontab

# Edit crontab
crontab -e

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

Способ 3: Использование systemd (опционально)

Создайте /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

Затем включите:

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

Функции безопасности

Изоляция рабочего пространства: Файловые операции ограничены WORKSPACE_ROOT
Аутентификация по токену: Токен клиента + токен администратора
Ограничения путей: Предотвращение несанкционированного доступа
Белый список интерпретаторов скриптов: Разрешены только безопасные интерпретаторы
Ограничения выполнения команд: Настраиваемые ALLOW_BASH_EXEC и ALLOWED_COMMANDS

История версий

См. CHANGELOG.md

Лицензия

Лицензия MIT — см. LICENSE

Участие в разработке

Сообщения об ошибках и Pull Request приветствуются!

Tool Schema Changelog

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

Loading tool schema changelog…

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

ActivityMaintained

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

EXZA Remote - AI Computer Commander
io.github.exzade
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
OS Automation Command Line Shell Access
1
https://remote.exza.de/mcp
Node Command
io.github.huseyincig
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
File Systems Shell Access Browser Automation
1
https://mcp.nodecommand.app/mcp
Ovrin
io.github.joshluberisse
Secure Linux sandboxes for AI agents, as MCP tools.
Code Execution Shell Access Virtualization
1
https://mcp.ovrin.app/mcp
Speakeasy Platform MCP
com.speakeasy.ai
Secure and manage MCP servers through the Speakeasy AI Control Plane from your agent.
Developer Tools Security Agent Orchestration
1278
https://ai.speakeasy.com/platform-mcp

Related MCP Servers

sshand
Shell Access Command Line File Systems
muradmalik23
A
license
A
quality
C
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 2 months ago (2026-09-10 04:02 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 8 months ago (2026-03-13 03:00 UTC)
17
10 npm
MIT
SSH MCP Server
Shell Access Command Line
fionarchl
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.
Updated 5 months ago (2026-06-27 16:15 UTC)
19,563 npm
MIT
cokacremote
Command Line File Systems OS Automation
jeong-jimin-github
A
license
Not graded
quality
C
maintenance
Enables AI clients to operate on a remote Linux server over MCP, allowing shell command execution, file editing, package installation, project builds, and service management.
Updated 2 months ago (2026-09-03 13:34 UTC)
MIT

Appeared in Searches

A server for Linux file operations

mcp-remote-agent

Краткий обзор

Основные возможности

Быстрый старт

1. Клонируйте репозиторий

2. Установите зависимости

3. Настройте

4. Синхронизируйте конфигурацию

5. Разверните удаленный демон

6. Перезапустите ИИ-инструмент

Поддерживаемые ИИ-инструменты

Список инструментов

Структура каталогов

Файлы конфигурации

Панель управления

Включение панели управления

Доступ к панели управления

Функции панели управления

Настройка автозапуска

Способ 1: Использование setup-autostart.sh (рекомендуется)

Способ 2: Ручная настройка crontab

Способ 3: Использование systemd (опционально)

Функции безопасности

История версий

Лицензия

Участие в разработке

Tool Schema Changelog

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

sshand

SSH MCP Server

SSH MCP Server

cokacremote

Appeared in Searches