Runcloud Server Management MCP

🪶 鲈鱼

服务器的智能层。

一个人工智能原生、自我托管、自我学习的大脑，可以监视你运行的每一台服务器，用简单的英语诊断出故障，并生活在你想去的任何地方——克劳德代码、电报、Slack、你的终端、任何讲HTTP的地方。

     

安装 · 为什么选择Perch · 比较 · 命令 · 建筑

______________________________________________________________________

30秒投球

• 人工智能原生，未经改造。 从第一天起就围绕Claude Code构建。您的AI通过150多个MCP工具与您的服务器进行通信。
• 自我托管的情报。 每台服务器、每款网络应用、每一个问题、每一次修复——都保存在硬件上的本地SQLite大脑中。没有其他人拥有你的运营历史。
• 简明英语诊断。 不是“错误500”。请尝试： *“插件X刚刚更新，现在与主题Y冲突。我停用了X，网站也恢复了。”*
• 连接器，不锁定。 电报。松弛。Webhooks。电子邮件。CLI。任何涉及HTTP的内容。选择一个或全部使用。
• 永远免费，无需按服务器纳税。 在1个VPS或100上运行它。同样的价格：零。没有“Pro tier”，没有许可证密钥，没有地毯拉。

______________________________________________________________________

为什么存在

2026年4月，你有四种方法来托管一个严肃的网站。它们都很糟糕：

真实主机市场

大多数人选择GoDaddy是因为他们不知道更好。 聪明的人选择Cloudways是为了方便，并支付了他们应该支付的3倍。其余的人变成了原始的VPS，成为了意外的系统管理员。

RunCloud 这确实是没有人听说过的最聪明的基础设施：

• 提供商自由 --适用于任何云（Hetzner、DigitalOcean、AWS、Vultr、Linode、您自己的金属）。Cloudways将你锁定在5。
• 你保持根。 Cloudways不会给你根。RunCloud确实如此。
• 随时停止付款。 您的VPS会与您的所有网站一起运行。Cloudways=要么付出代价，要么失去一切。
• 堆叠灵活性。 纯NGINX或混合Apache+NGINX。你的电话。Cloudways=拿走他们给你的东西。
• 真正的隔离。 每个web应用程序都以自己的系统用户身份运行。错误仍在范围内。
• 面板价格为每月8美元。 无需缴纳每个站点的税。

所以： Hetzner CX 21（每月5美元）+runcloud（每月8美元）=每月13美元。 你可以在同一个盒子里用WordPress+Laravel+Node+n8n+其他任何东西得到相当于Kinsta（35美元-115美元）的东西。您硬件上的数据。

捕获？RunCloud是一个 管理面板。它不看。它不能诊断。它不会愈合。它不会学习。

那是珀奇住的地方。

______________________________________________________________________

没有人在做什么

无人运输的物品： 一个开源的、人工智能原生的智能层，在您自己的服务器上运行，随着时间的推移学习您的堆栈，在您想要的任何渠道与您交谈，并且从不向您发送续订电子邮件。那是珀西。

______________________________________________________________________

珀斯体验

来自克劳德代码

You:    /perch wp audit mysite.com
Perch:  📊 Running full audit on mysite.com...

        Database: 8.4MB autoload (urgent — should be  **HTTP API工具目录：** 每个暴露的工具 `perch-api` 关于HTTP的文档记录在 [`docs/api-tools.md`](./docs/api-tools.md) --55个工具（大脑、对话、只读诊断、WordPress审计、WordPress变异、保险库、SSH原语），带有所需的参数、变异与否标志，以及它们向哪些脚本输出。

perch/ ├── src/ │ ├── index.ts ← MCP server (150+ tools — RunCloud + Perch) │ ├── core/ │ │ ├── brain.ts ← SQLite knowledge base (your data, your server) │ │ ├── gateway.ts ← Alert formatter (friendly tone, multi-channel) │ │ └── ssh-enhanced.ts ← SSH with password + private key + WP-CLI helper │ └── modules/ │ └── wordpress/ ← The WordPress Audit Modules │ ├── db.ts ← Autoload audit, transient cleanup, orphan detection │ ├── plugins.ts ← Plugin audit + Wordfence Intelligence CVE scan │ ├── security.ts ← 12-check hardening, scored 0–100 │ ├── backup.ts ← Backup health, last run age, destination check │ ├── images.ts ← CLI image optimization (jpegoptim/optipng/cwebp) │ ├── perf.ts ← Performance snapshot (cache, cron, PHP, TTFB) │ └── errors.ts ← Error diagnosis + white screen root cause │ ├── telegram-bot/ ← Telegram connector (one of many) │ ├── bot.py ← Polling bot with inline keyboards │ ├── fix-server.py ← Local HTTP API (127.0.0.1 only) │ ├── monitor.sh ← Cron-based health alerting │ ├── setup.sh ← Interactive setup wizard │ └── scripts/ ← Shell scripts for each fix action │ ├── docs/ │ ├── runcloud.md ← Full RunCloud server reference (nginx-rc, paths, gotchas) │ ├── install.md ← Setup guides — MCP, connectors, both │ ├── telegram.md ← Telegram connector deep-dive │ ├── slack.md ← Slack connector setup │ └── safety.md ← What Perch will and won't do (read this) │ └── README.md ← You are here

______________________________________________________________________

## WordPress审计模块——Perch在您的网站上看到的内容

WordPress端不需要插件。一切都通过SSH和WP-CLI运行。RunCloud感知（了解 `nginx-rc`, `/etc/nginx-rc/`，每个应用程序用户 `/home/{user}/webapps/`).

|模块|捕获|
|--------|---------|
| **数据库** |自动加载膨胀（Elementor、过期的瞬态、孤立的WC会话、后元孤立、表碎片、查询速度慢）|
| **插件** |通过Wordfence Intelligence的漏洞插件（免费，没有API密钥），废弃的插件（两年以上没有更新），隐藏的非活动插件仍在磁盘上|
| **安全** |管理员用户名=“Admin”，xmlrpc.php已公开，wp-config权限已启用，文件编辑器已启用，debug.log可公开访问，缺少速率限制，标头中公开了wp版本，核心校验和不匹配|
| **备份** |上次运行时间、缺少数据库转储、截断备份文件、无法访问S3/目标、保留不匹配|
| **图像** |无损JPEG/PNG压缩（jpegoptim、optipng、pngquant），与原件一起生成WebP，运行前估算节省，按计划或按需|
| **演出** |PHP版本EOL，对象缓存（Redis/Memcached）连接了吗？、页面缓存类型、WP cron运行状况和积压、来自服务器的TTFB、插件计数阈值|
| **错误** |解析PHP错误日志，按类型分类，识别违规插件/主题，检测插件冲突，白屏根本原因，建议一行WP-CLI修复|

当有东西坏了，你会得到这个：

🔴 White screen on mysite.com

Fatal error: Cannot redeclare 'my_custom_helper' Conflict between: wp-content/plugins/my-plugin/includes/helpers.php:23 wp-content/themes/mytheme/functions.php:89

my-plugin was updated 2 hours ago — likely introduced this.

[🔇 Deactivate my-plugin] [📋 Full Error Log] [↩️ Roll Back Plugin]

没有堆栈跟踪。不是“内部服务器错误” **诊断**.

______________________________________________________________________

## 自动化规则

每个珀斯人都会为船只安装 **14个内置监控规则** 每5分钟通过cron运行一次。没有n8n。没有Zapier。没有SaaS。整个引擎是一个自包含的shell脚本(`telegram-bot/monitor.sh`)--大约400行，运行时间不到2秒。

|#|规则|默认触发器|自动操作|
|---|---|---|---|
|1|nginx/nginx rc down |服务未激活|电报警报+重启按钮|
|2|PHP-FPM关闭（任何版本）|任何 `php*-fpm-rc` 非活动|重新启动按钮|
|3|MySQL/MariaDB关闭|服务未激活|重启按钮+OOM上下文|
|4|磁盘使用分层|80%/90%/95%|分层警报+清理按钮|
|5|RAM使用率分层|85%/93%|顶级消费者+智能修复|
|6|CPU持续负载|100%/200%的内核|顶级进程|
|7 |孤立进程（PPID=1）|>10个孤立进程|智能修复|
|8|失败的systemd服务|任何 `systemctl --failed` |智能修复|
|9|每个站点的SSL到期|剩余30d/7d |续订SSL按钮|
|10|站点HTTP可用性|5xx或无法访问|诊断+修复按钮|
|11 |自定义端口检查|关闭任何配置的端口|智能修复|
|12 |封禁率飙升|>50封/小时|确认|
|13 |备份时间|>自上次备份以来36小时|确认|
|14 |每日心跳|当地时间09:00 |“所有系统良好🪶" |

每一个门槛都是可以超越的 `~/.perch/.env`。每个警报都是友好的、上下文相关的，并配有一键操作按钮。冷却逻辑可防止垃圾邮件警报（默认值：相同警报之间间隔30分钟）。

`bash scripts/setup.sh` 安装cron行并提示您输入阈值。完整参考： [docs/automation.md](docs/automation.md).

______________________________________________________________________

## 连接器

连接器是Perch与你交谈的方式。挑一个。全部挑。添加您自己的——网关只是一个接受结构化警报并返回有效负载的函数。

|连接器|状态|最适合|
|-----------|--------|----------|
| **克劳德代码MCP** | ✅ 一流|深度工作——审计、规划、调试|
| **电报机器人** | ✅ 准备就绪|手机上全天候提醒，内联按钮修复|
| **Slack webhook** | ✅ 警报工作|团队频道，每日摘要|
| **Slack机器人** （斜线命令+按钮）|🔜 2026年第二季度|与Telegram完全对等|
| **HTTP webhook** | ✅ 准备好了|插入任何东西（n8n、Zapier、Make、自定义）|
| **电子邮件** | 🔜 即将到来|不参与聊天的利益相关者|
| **Discord 的中文翻译是“不和谐”或“纷争”。** | 🔜 社区公关欢迎|独立开发者/社区服务器|
| **自定义** | ✅ 构建自己的|实施 `formatAlert(opts)` --完成了|

Telegram和Slack今天都在工作。松弛的内联按钮+斜线命令将于2026年第二季度发布。其他连接器每条有50-200条线——欢迎PR。

______________________________________________________________________

## 安全

珀西天生多疑。在生产设备上安装之前，请阅读以下内容： **[docs/safety.md](docs/safety.md)**

**四个承诺：**

1. **未经确认，不得破坏。** 插件停用、文件删除、配置更改——所有这些都需要明确的确认点击。
1. **凭据永远不会泄露。** 密码/SSH密钥/API令牌在静止时使用AES-256-GCM加密。从每个日志、每个警报、每个错误消息中编辑。
1. **总是可逆的。** 记录了最后10个已确认的操作。 `/perch undo` 还原最新的。数据库内容修改从不自动运行。
1. **总是诚实的。** 当Perch修复了一些东西时，你会得到一份完整的报告，说明之前、之后发生了什么变化，以及为什么发生了变化。

**自动修复白名单** （无需确认）：重新启动崩溃的服务，杀死孤立进程，截断>50MB的日志，续订SSL\<7d，清除过期的瞬态，清除 `/tmp` 超过24小时的PHP会话。

**需要确认**：任何修改内容、停用插件、编辑配置、停止服务、重新启动的操作。

**永远不要开车**：备份还原、数据库内容 `DELETE`/`UPDATE` 用户数据、文件系统 `rm` 外面 `/tmp`，用户帐户更改，Hetzner级别关闭。

______________________________________________________________________

## 为什么永远免费

三个原因，都是诚实的：

1. **大脑属于你。** 一个存在于服务器上的免费工具不能是付费的、广告资助的或地毯式的。数据是你的。密码是你的。整堆都是你的。

1. **按服务器征税是错误的商业模式。** Cloudways收取基础VPS 220%的费用。Kinsta收费35美元/处。按您已经拥有的服务器向您收费是寻租行为。珀奇拒绝玩那个游戏。

没有“专业版”。没有许可证密钥。默认情况下没有遥测。不依赖SaaS。 **永远。**

______________________________________________________________________

## 路线图

**现在（2026年4月）** --Sprint 1已发货

- ✅ 配备150多种工具的MCP服务器
- ✅ WordPress审计模块（7个深度模块）
- ✅ SQLite自主学习大脑
- ✅ 带有内联按钮的电报机器人+修复服务器
- ✅ 通过webhook轻松传递警报
- ✅ RunCloud感知路径(`nginx-rc`, `/etc/nginx-rc/`，每个应用程序用户）

**未来60天**

- 🔜 凭证库（AES-256-GCM加密）
- 🔜 撤消系统(`/perch undo`)
- 🔜 Slack机器人（斜线命令+按钮，完全Telegram奇偶校验）
- 🔜 多服务器仪表板（Telegram优先代理视图）
- 🔜 正常运行时间Kuma webhook集成
- 🔜 自我更新流程(`/perch update`)

**2026年第3季度**

- 🔜 Laravel模块（队列健康、调度运行器、手工自动化）
- 🔜 Node.js模块（PM2深度监控、内存泄漏检测）
- 🔜 n8n模块（工作流健康、执行审计）
- 🔜 模式识别v2（Perch跨服务器关联问题——“这是本月第三次，这是永久修复”）

**2027**

- 跨服务器联合学习（选择加入，匿名）——Perch在没有任何人放弃数据的情况下从网络中学习

______________________________________________________________________

## 由Aditya建造

Aditya Sharma——独立开发者，开源。营销和增长主管 [位置创新](https://posimyth.com).经营自己的基础设施。建造Perch是因为他厌倦了在200美元/月的Kinsta和凌晨4点的SSH恐慌之间做出选择。

不隶属于RunCloud。珀西作品 **和** RunCloud——RunCloud是安全层（GUI+隔离+备份），Perch是上面的智能层。两者都需要。它们共同取代了每月13美元的35-115美元的托管服务。

______________________________________________________________________

**停止租用服务器的智能。开始拥有它。**