FatalGuard

io.github.zinoodev85由 GitHub 账号 zinoodev85 发布v1.3.1更新于 Nov 8, 2026

Read-only MCP server inside WordPress: PHP error logs, debug.log and fatal errors.

已验证Streamable HTTP可网页运行开发者工具安全与监控

概览

AI 生成的概览

WordPress 插件内置的只读 MCP 服务器，让助手查看站点的 PHP 错误日志、debug.log 和致命错误。

可以做什么
  • 查看日志记录状态与 FatalGuard 设置
  • 列出可读取的日志来源及其大小
  • 读取某个日志的最新若干行，敏感信息会被遮蔽
  • 列出按次数和最近出现时间分组的错误
  • 列出最近捕获的致命错误并查看单条详情
适用场景
当 WordPress 站点频繁出现警告或“严重错误”白屏，希望助手读取日志和致命错误、帮助定位崩溃原因时使用。仅在 WordPress 仍能正常加载时可用。
运行要求
在 WordPress 站点上安装并启用 FatalGuard 插件，并连接到该站点的 wp-json fatalguard MCP 远程 streamable HTTP 端点。需在 wp-admin 的 FatalGuard → AI (MCP) 页面生成 API 密钥，并通过 X-FatalGuard-Key 请求头发送。需要能访问该站点的网络。
安装前请注意
API 密钥只显示一次，可读取站点错误日志，请妥善保管，不再需要时在同一页面撤销。日志内容可能包含敏感信息，尽管读取日志行的工具会遮蔽密钥。六个工具均为只读，助手无法修改站点。

安装

在 SourceWeft 中

  1. 打开 控制台中的 FatalGuard，将其添加到工作区。
  2. 连接 X-FatalGuard-Key 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

FatalGuard — PHP error log viewer, fatal error alerts and MCP server for WordPress

FatalGuard is a WordPress plugin. It shows your debug.log and PHP error log in wp-admin, catches the fatal error behind the "critical error" white screen, sends Telegram alerts with a one-tap recovery link, and runs its own read-only MCP server, so Claude, Cursor or VS Code can read your site's errors.

This repository is a read-only mirror of the free plugin, version 1.3.1. Development happens elsewhere; issues and questions go to the support forum.

Install

Install it from wordpress.org, so your site gets automatic updates:

A zip from this repository works too (Plugins → Add New → Upload Plugin). It uses the same slug and has no Update URI header, so WordPress updates it from wordpress.org.

Connect an AI client (MCP)

  1. In wp-admin, open FatalGuard → AI (MCP) and press Generate API key. Copy the key: it is shown only once. The same page shows these snippets with your URL and key filled in.
  2. Add the server to your client. Replace example.com with your site and paste your key.

Endpoint: POST https://<your-site>/wp-json/fatalguard/v1/mcp (streamable HTTP). The key goes in the X-FatalGuard-Key header. Some Apache hosts strip Authorization: Bearer, so use this header.

Claude Code (run in your terminal)

sh
claude mcp add --transport http fatalguard "https://example.com/wp-json/fatalguard/v1/mcp" --header "X-FatalGuard-Key: PASTE-YOUR-API-KEY-HERE"

Cursor — mcp.json

json
{  "mcpServers": {    "fatalguard": {      "type": "http",      "url": "https://example.com/wp-json/fatalguard/v1/mcp",      "headers": {        "X-FatalGuard-Key": "PASTE-YOUR-API-KEY-HERE"      }    }  }}

VS Code — .vscode/mcp.json

json
{  "servers": {    "fatalguard": {      "type": "http",      "url": "https://example.com/wp-json/fatalguard/v1/mcp",      "headers": {        "X-FatalGuard-Key": "PASTE-YOUR-API-KEY-HERE"      }    }  }}

Claude Desktop — claude_desktop_config.json (via mcp-remote)

json
{  "mcpServers": {    "fatalguard": {      "command": "npx",      "args": [        "mcp-remote",        "https://example.com/wp-json/fatalguard/v1/mcp",        "--header",        "X-FatalGuard-Key: PASTE-YOUR-API-KEY-HERE"      ]    }  }}

Then ask: "What's crashing my site?" or "Which warnings keep coming back?"

Tools

All six are read-only. The AI cannot change anything on your site.

ToolWhat it returns
statusLogging status and FatalGuard settings
list_log_sourcesThe logs FatalGuard can read, with size
tail_logThe newest lines of one log, secrets redacted
list_errorsErrors grouped with counts and last seen
list_recent_fatalsRecently captured fatal errors
get_fatalOne fatal error in detail

The server works while WordPress can still load. For a site that is fully down, use the recovery link from the fatal alert. Revoke the key at any time on the same page.

Try it without a site (Docker)

The repository builds a sandbox: a throwaway WordPress (SQLite, no web server) with FatalGuard active and some demo errors, speaking MCP over stdio.

sh
docker build -t fatalguard-mcp . && docker run -i --rm fatalguard-mcp

It is a demo to see the tools and their answers. Real use is the plugin on your own site, connected as shown above.

License

GPLv2 or later. See LICENSE.txt.

来源：README.md，提交 94a3433

工具

0
该服务器需要 API 密钥等凭据，因此 SourceWeft 无法在没有凭据的情况下读取其工具，也未收录。

版本历史

1
  1. v1.3.1最新Nov 8, 2026

评分

已满足适用检查项的 60%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分