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 分