verifyfirst

io.github.simulacra由 GitHub 帳號 simulacra 發布v1.8.0更新於 Oct 24, 2026

Look up what your verification method cannot see: 48 failures that report success.

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

讓助理查詢驗證盲區，以及那些回報成功卻實際失敗的案例，並依漏掉它們的驗證工具分類。

可以做什麼
提供一個包含 48 個「看似成功」失敗案例的登錄庫，依漏掉它們的驗證工具分組。工具包括：from_symptom 依觀察到的症狀找出對應失敗；blind_spots 列出某個驗證工具看不見的內容；list_instruments 與 get_instrument 檢視工具細節；search 與 get_entry 檢索登錄庫；get_protocol 提供在聲稱工作完成前的五步檢查清單。
適用情境
當出現問題但原因不明時，或在任務進行中需要判斷某種驗證方式（例如截圖、結束碼、HTTP 狀態碼）能否真正發現你關心的失敗時，適合使用。
執行需求
以 Python 套件（verifyfirst-mcp）形式透過 stdio 在本機執行，通常以 uvx 或 pip 安裝。未宣告需要帳號、API 金鑰或環境變數。可離線使用內建登錄庫；--remote 選項會讀取線上登錄庫，失敗時回退到內建副本。
安裝前請注意
屬於唯讀查詢：回傳參考資訊，不會修改你的專案。啟用 --remote 時會從 verifyfirst.dev 取得資料，查詢內容會離開本機。登錄庫條目被描述為「已觀察」或「有文獻依據」，並非假設案例。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 verifyfirst，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

verifyfirst-mcp

An MCP server for what your verification method cannot see.

A failure that crashes is cheap. A failure that reports success is expensive: the screenshot looks fine, the command exits zero, the endpoint returns 200, and the bug ships.

This server exposes verifyfirst.dev — a registry of 48 such failures, organised by the instrument that missed them rather than by the technology involved, because the instrument is what you know before you know the bug.

Install

bash
uvx verifyfirst-mcp          # run it directlypip install verifyfirst-mcp  # or install it

Register with Claude Code:

bash
claude mcp add verifyfirst -- uvx verifyfirst-mcp

Or any MCP client:

json
{  "mcpServers": {    "verifyfirst": { "command": "uvx", "args": ["verifyfirst-mcp"] }  }}

Tools

ToolWhat it does
from_symptom(description)Start here when something is wrong but you do not know why. Describe what you see — "deploy ran but nothing changed", "200 but the data is wrong" — and get the failures that produce that appearance, each with its check.
blind_spots(instrument)The one to reach for mid-task. What an instrument cannot see, terse. Takes loose names — curl, 200, pgrep, systemctl, stdout, playwright all resolve.
list_instruments()All six instruments.
get_instrument(id)Full detail plus every recorded failure it missed, each with its check.
search(query)Substring search across the registry.
get_entry(id)One entry, e.g. NS-001.
get_protocol()A five-step checklist for claiming work is done.

Example

> blind_spots("screenshot")
screenshot (A rendered image) is blind to:  - Time. A still frame cannot distinguish 'renders one frame then stops'    from 'renders one frame correctly'.  - Whether scripts ran at all, as opposed to running and producing this.  ...

Notes

Zero dependencies — Python standard library only. Works offline from a bundled copy of the registry; pass --remote to read the live one, which falls back to the bundle on any failure.

Every entry in the registry is a failure that genuinely occurs, marked observed (diagnosed first-hand) or documented (primary source cited and the check reproduced). None are hypothetical.

CC0-1.0 — public domain. Maintained by Zion Labs.

來源：pypi/README.md，提交 93dd19c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.8.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。