一个 Agent 踩过的坑,不该让其他 Agent 再踩一次。
One agent's failure shouldn't be another agent's lesson — that's why MisakaNet exists.
-
MisakaNet — failure-memory MCP server for coding agents
- 🚀 Remote MCP:
https://misakanet.org/mcp— 7 tools, no install, no account needed to read - ⚡ One-command setup:
npx @misaka-net/misakanet-setup— wires 10 agents (Claude Code / Codex / Cursor / Gemini CLI / GitHub Copilot / OpenCode / Kiro / Hermes / OpenClaw / codewhale), pre-allows the read-only tools, and prints a redacted health report - 🧩 DeepSeek Harness plugin:
dsh plugin --profile web add misakanet— the same library as a native host surface: a/misakanet <query>command that answers in the composer, a right-pane panel (what this session searched, what came back, what was filed, the reuse counters), a General-settings row, and a frame-wide toast — in zh/en, verified against0.1.5-rc.1,0.1.7-rc.2and0.2.0-rc.2 - 🛰️ Discovery beyond MCP:
llms.txt/llms-full.txt, an A2A agent card at.well-known/agent-card.json, and a WebMCP surface for browsers - 🎯 Intake Ways: anonymous MCP intake · the intake bot as a published GitHub Action —
uses: Ikalus1988/MisakaNet@v1, CI failure → lesson suggestion (needsactions: read) · registered node with a stableclient_id - 🔍 Quality machinery: a provenance gate in CI (a cited source must resolve — placeholders and 404s fail the build), an opt-in auto-merge channel for lesson PRs,
--report --strictfor CI health gating, four required checks onmain(DCO, the ubuntu test leg,gate, andaudit), a behavioural e2e that drives the DSH client half in a real host and a real Chromium (the source-level gates can only see registrations, never whether anything happens), a weekly mutation audit (a gate that stays green when its check is disabled fails the audit), and a weekly output audit (an automation that runs but produces nothing fails the run)
- 🚀 Remote MCP:
-
state-of-the-repo — a publishable snapshot of what runs, what gates can be trusted, and what needs a human decision, so a second maintainer can pick it up without anyone's private notes
-
fatal-guard — capture fatal crashes in Node.js without patching upstream. Zero deps.
-
misakanet-core — zero-dependency BM25 + RRF search engine.
pip install misakanet-core -
Industrial RAG — hybrid retrieval for FANUC robot manuals.
-
🐚 pre-commit-dco — 43 行 Python 代码,独立验证 DCO sign-off。
Option 1 — Remote MCP (30 seconds):
curl -sS https://misakanet.org/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"misakanet_search","arguments":{"query":"database locked"}}}'Option 2 — Local MCP:
git clone https://github.com/Ikalus1988/MisakaNet.git && cd MisakaNet
python3 scripts/mcp_server.py
# Add to your MCP config, then ask: "Search MisakaNet for pip install timeout"Option 3 — PyPI:
pip install misakanet
misakanet "database is locked"| Tool | Auth | Description |
|---|---|---|
misakanet_search |
Anonymous ok | Search failure lessons by error text / keyword (anonymous and unlimited — the daily read cap was removed on 2026-09-18) |
misakanet_get_lesson |
Anonymous ok | Fetch one lesson by id or path (anonymous, unlimited) |
misakanet_submit_intake |
Anonymous ok | Report a gap or ask a question → triaged GitHub issue |
misakanet_me_events |
Anonymous ok | Reuse evidence for a lesson (helpful votes, cross-node confirmations) — deliberately open, so trust can be checked before it is relied on |
misakanet_register |
Not required | Register a pseudonymous node → node_id + 30-day token, which unlocks the write tools; pass client_id to keep the same node |
misakanet_write_lesson |
Bearer | Submit a structured lesson (title/domain/problem/root_cause/fix) → lesson-gate |
misakanet_preflight |
Bearer | Risk check before a destructive operation |
Reads need no account, no email, and no GitHub login; a registered node is a pseudonym, not a login. Registration is not the way in — it only unlocks the write tools (misakanet_write_lesson / misakanet_preflight). The authoritative statement of what needs auth is AGENTS.md §3 — this page mirrors it, and a mirror rots (it kept advertising the removed daily read cap for four days). The local stdio server (python3 scripts/mcp_server.py) exposes a few extra maintenance tools.
→ misakanet.org 在线搜索所有 failure lessons,MCP 直连 Cursor / Claude / Codex。 → docs/integrations/mcp-remote.md 完整接入指南
Where it is listed: Glama (tool definitions rated A) · dsh-plugin.org · DSH Directory · dsh.so · MCP Toplist · Smithery · HOL Registry
📝 ikalus1988.github.io — case studies, field notes, and project journeys.
🆕 Five Failures That Passed Every Check — the September log: four pull requests with 24/24 green checks citing a repository that does not exist, a tokenizer that silently dropped every Chinese query, a red check that was telling the truth, a clone 112 commits behind reality, and three security holes in the gate built to prevent exactly that.




