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

用于 AI 智能体远程开发的 MCP 服务器

使 AI 智能体能够通过 MCP 协议操作远程 Linux 服务器，无缝连接本地开发环境与远程服务器。

License: MIT Version

中文文档

一句话总结

使 AI 智能体（如 WorkBuddy、Claude Desktop、Cursor）能够通过 MCP 直接读写远程 Linux 服务器文件并执行命令，无缝连接本地开发与远程服务器。

类比：VS Code Remote SSH 是给人类用的；mcp-remote-agent 是给 AI 用的。

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`	目标 AI 工具的 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. 重启 AI 工具

配置生效后，重启您的 AI 工具以激活 MCP 注册。

支持的 AI 工具

AI 工具	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 提供了一个 Web 仪表盘用于监控和管理：

启用仪表盘

在 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

贡献

欢迎提交 Issue 和 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. 重启 AI 工具

支持的 AI 工具

工具列表

目录结构

配置文件

仪表盘

启用仪表盘

访问仪表盘

仪表盘功能

自动启动配置

方法 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