npm failmodes-mcpstreamable-httpMITupdated 2mo ago
MCP server for the Fail Modes taxonomy — a machine-readable knowledge base of AI system failure modes.
failmodes 能做什么?
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
| Tool | Description |
|---|---|
search_failure_modes |
Search by symptom text or keyword phrase. Returns ranked matches. |
get_failure_mode |
Retrieve the full structured record for a failure mode by ID slug. |
list_categories |
List all taxonomy categories with descriptions and mode counts. |
list_modes |
List all modes, optionally filtered by category ID. |
Quick Start
No installation required — run directly with npx:
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):
{
"mcpServers": {
"failmodes": {
"command": "npx",
"args": ["-y", "failmodes-mcp"]
}
}
}
Cursor / VS Code
Add to your MCP settings file:
{
"mcpServers": {
"failmodes": {
"command": "npx",
"args": ["-y", "failmodes-mcp"]
}
}
}
Remote (no install required)
A hosted Streamable HTTP version is also available — no npm package needed:
{
"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
- Taxonomy source: github.com/elyngved/failmodes-taxonomy
- Website: failmodes.com
- Remote MCP manifest: failmodes.com/server.json
License
MIT
安装
把 failmodes 添加到你的客户端。选择你正在使用的那个。
{
"servers": {
"failmodes-mcp": {
"type": "http",
"url": "https://www.failmodes.com/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add failmodes-mcp -- npx -y failmodes-mcpcodex mcp add failmodes-mcp -- npx -y failmodes-mcpamp mcp add failmodes-mcp -- npx -y failmodes-mcp{
"mcpServers": {
"failmodes-mcp": {
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"failmodes-mcp": {
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"failmodes-mcp": {
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"failmodes-mcp": {
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"failmodes-mcp": {
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"failmodes-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"failmodes-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"failmodes-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"failmodes-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y failmodes-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
4 个工具
failmodes 向已连接的智能体提供 4 个工具。
- search_failure_modes
- Search by symptom text or keyword phrase. Returns ranked matches.
- get_failure_mode
- Retrieve the full structured record for a failure mode by ID slug.
- list_categories
- List all taxonomy categories with descriptions and mode counts.
- list_modes
- List all modes, optionally filtered by category ID.
评分
68 / 100
良好
- 文档18/25
- 维护16/25
- 可信度13/20
- 能力6/15
- 安装体验15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 57 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.1.0最新 | 2026年7月5日 |