stfade/moth
FreeNot checkedA lightweight MCP server for structured bug-fix analysis and project-local verified fix memory for AI agents.
About
A lightweight MCP server for structured bug-fix analysis and project-local verified fix memory for AI agents.
README
Moth
Moth is a lightweight MCP server for project-local bug-fix analysis and verified fix memory.
What Moth Does
Moth receives error output through MCP, redacts likely secrets, normalizes the failure, detects the likely stack, checks project-local fix memory, and returns a structured fix brief.
Moth does not edit code, run shell commands, crawl repositories, require a backend, or maintain a global bug database.
Why Moth?
Bug-fix context is often local to a project: the command that failed, the framework in use, nearby configuration, and fixes that have already worked or failed in that repo.
Moth keeps that workflow small and explicit. It analyzes provided error context, suggests a best first fix, and records only verified fix outcomes in project-local memory.
Quick Start
Requires Node.js 18+.
Run directly:
npx -y @stfade/moth moth-mcp
Or install globally:
npm install -g @stfade/moth
moth-mcp
Generic MCP config
{
"mcpServers": {
"moth": {
"command": "npx",
"args": ["-y", "@stfade/moth", "moth-mcp"]
}
}
}
Usage Example
When using Moth with a supported AI agent, you can include a simple prompt like this along with your error:
"Use Moth to analyze this error before fixing it."
Supported Clients
| Client | Status | Setup |
|---|---|---|
| Codex | Local plugin-ready | Setup |
| Claude Code | Local plugin-ready | Setup |
| Cursor | Plugin scaffold | Setup |
| Gemini CLI | Extension scaffold | Setup |
| Gemini Antigravity | MCP config-ready | Setup |
| OpenCode | MCP config-ready | Setup |
| Generic MCP | Config-ready | Setup |
“Local plugin-ready” means the integration wrapper is included and can be tested locally. Marketplace submission and approval are not included yet.
Tools
Moth exposes exactly two MCP tools.
analyze_error
Analyzes provided error output before a fix is attempted.
Input fields:
error_outputcommand?cwd?package_context?relevant_files?environment?
Output fields:
analysis_idfingerprintstacklikely_causebest_first_fixverificationprior_project_fixesavoidconfidence
remember_fix_result
Records verified project-local fix memory.
Input fields:
analysis_idfingerprintstackfix_attemptedverification_commandverification_result: "passed" | "failed"notes?
The public worked input is rejected. worked is derived from verification_result.
Verified Memory Lifecycle
analyze_error
→ apply/attempt fix
→ run verification command
→ remember_fix_result
Call remember_fix_result only when:
- a fix/change was actually attempted
- the verification command actually ran
- the result is clearly
passedorfailed
Do not call it for suggestions, skipped changes, missing verification, ambiguous results, or guesses.
Local Memory
Verified project-local fix memory is stored at:
.moth/fix-memory.jsonl
Moth keeps a small Moth-owned analysis registry outside the project so remember_fix_result can map analysis_id back to the correct project path after an MCP server restart.
Skills
Moth includes concise skills for compatible agents:
moth-debug-first-fixmoth-source-backed-researchmoth-verify-fix
The MCP server itself does not perform live web research. Compatible agents may use their own search tools, guided by Moth skills, when external sources are needed.
Safety
- read-only by default
- no source edits
- no shell execution
- no repo-wide scan
- no background watcher
- no external service required
- redacts likely secrets before analysis, responses, and memory writes
Development
pnpm install
pnpm test
pnpm build
pnpm dev
npm pack --dry-run
License
MIT
Install stfade/moth in Claude Desktop, Claude Code & Cursor
unyly install stfade-mothInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add stfade-moth -- npx -y @stfade/mothFAQ
Is stfade/moth MCP free?
Yes, stfade/moth MCP is free — one-click install via Unyly at no cost.
Does stfade/moth need an API key?
No, stfade/moth runs without API keys or environment variables.
Is stfade/moth hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install stfade/moth in Claude Desktop, Claude Code or Cursor?
Open stfade/moth on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare stfade/moth with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
