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, обеспечивая бесшовное соединение локальных сред разработки с удаленными серверами.

License: MIT Version

中文文档

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

Позволяет ИИ-агентам (таким как 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 приветствуются!

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

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

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

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

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

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

3. Настройте

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лицензия

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

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

sshand

SSH MCP Server

MCP SSH Server

SSH MCP Server

Appeared in Searches