Failmodes

io.github.elyngved由 GitHub 帳號 elyngved 發布v0.1.0更新於 Oct 24, 2026

MCP server for the Fail Modes taxonomy — a knowledge base of AI system failure modes

已驗證Streamable HTTP可網頁執行知識與記憶AI 與機器學習

概覽

AI 產生的概覽

一個唯讀的 MCP 伺服器，提供 Fail Modes 分類法，讓助理依症狀、關鍵字或 ID 搜尋與查閱已記錄的 AI 系統失效模式。

可以做什麼
依症狀文字或關鍵字詞組搜尋失效模式，回傳含 ID、名稱、類別與符合上下文的排序結果。依 ID slug 取得單一失效模式的完整結構化記錄。列出所有分類法類別及其 ID、名稱、描述與模式數量。列出失效模式，可依單一類別篩選。
適用情境
適合在檢視、除錯或記錄 AI 系統行為時使用，藉由一套統一的失效模式名稱（例如引用幻覺、諂媚）來分析問題。也適合需要一致術語的提示詞與評估工作。
執行需求
可作為託管的 Streamable HTTP 端點執行，也可透過 npx（Node.js）在本機執行。本機套件在首次呼叫工具時從 failmodes.com 取得分類法資料並快取於記憶體中，因此需要網路連線。未宣告帳號、API 金鑰或環境變數。
安裝前請注意
工具為唯讀查詢，不會寫入、傳送或刪除資料。本機套件與託管端點都會從第三方網站取得分類法資料，因此查詢與使用情形會送達該服務。分類法內容屬第三方參考資料，應視為參考而非權威。

安裝

在 SourceWeft 中

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

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.elyngved%2Ffailmodes/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "failmodes": {
      "type": "http",
      "url": "https://www.failmodes.com/api/mcp"
    }
  }
}

README

failmodes-mcp

MCP server for the Fail Modes taxonomy — a machine-readable knowledge base of AI system failure modes.

Provides four tools over 100+ canonical failure mode records spanning factuality, alignment, planning, code generation, instruction following, and more.

Tools

ToolDescription
search_failure_modesSearch by symptom text or keyword phrase. Returns ranked matches.
get_failure_modeRetrieve the full structured record for a failure mode by ID slug.
list_categoriesList all taxonomy categories with descriptions and mode counts.
list_modesList all modes, optionally filtered by category ID.

Quick Start

No installation required — run directly with npx:

bash
npx failmodes-mcp

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{  "mcpServers": {    "failmodes": {      "command": "npx",      "args": ["-y", "failmodes-mcp"]    }  }}

Cursor / VS Code

Add to your MCP settings file:

json
{  "mcpServers": {    "failmodes": {      "command": "npx",      "args": ["-y", "failmodes-mcp"]    }  }}

Remote (no install required)

A hosted Streamable HTTP version is also available — no npm package needed:

json
{  "mcpServers": {    "failmodes": {      "url": "https://www.failmodes.com/api/mcp"    }  }}

How It Works

On first tool call, the server fetches current taxonomy data from failmodes.com and caches it in memory for the duration of the session. Requires internet access.

The stdio transport makes this compatible with any MCP client that supports running local processes (Claude Desktop, Cursor, VS Code, etc.).

Links

License

MIT

來源：README.md，提交 a20bcf3

工具

4

search_failure_modes

Search the Fail Modes taxonomy by symptom text or keyword phrase. Returns ranked matches with id, name, category, and matched context.

輸入參數symptom必填

get_failure_mode

Retrieve the full structured record for a single failure mode by its ID slug (e.g. 'citation-hallucination', 'sycophancy').

輸入參數id必填

list_categories

List all taxonomy categories with their IDs, names, descriptions, and mode counts.

無需輸入參數。

list_modes

List failure modes, optionally filtered to a single category by category ID.

輸入參數category

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分