Skip to content
View Ikalus1988's full-sized avatar

Block or report Ikalus1988

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Ikalus1988/README.md

Hi there 👋

一个 Agent 踩过的坑,不该让其他 Agent 再踩一次。

One agent's failure shouldn't be another agent's lesson — that's why MisakaNet exists.

🔧 What I Build

  • MisakaNet — failure-memory MCP server for coding agents

    Lessons Domains MCP Tools Stars

    • 🚀 Remote MCP: https://misakanet.org/mcp — 7 tools, no install, no account needed to read
    • One-command setup: npx @misaka-net/misakanet-setup — wires Claude Code / Codex / Hermes / OpenClaw / codewhale, pre-allows the read-only tools, and prints a redacted health report
    • 🎯 Intake Ways: anonymous MCP intake · misaka-intake-bot GitHub Action (CI failure → lesson suggestion) · registered node with a stable client_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, and --report --strict for CI health gating
  • 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。

🚀 Quick Start

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"

📚 MCP Tools (7 on the remote endpoint)

Tool Auth Description
misakanet_search Anonymous ok Search failure lessons by error text / keyword (5 reads/day/IP anonymously)
misakanet_get_lesson Anonymous ok Fetch one lesson by id or path (same read quota)
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; 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. 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 完整接入指南

📝 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.

Pinned Loading

  1. MisakaNet MisakaNet Public

    📚 A zero-dependency, git-backed micro-lesson library for AI Agents to asynchronously share and search verified debugging experience. Python stdlib only. | https://misakanet.org

    Python 493 189

  2. misakanet-core misakanet-core Public

    Zero-dependency BM25 + RRF search engine for failure lessons. pip install misakanet-core

    Python 1

  3. pre-commit-dco pre-commit-dco Public

    43-line Python hook that verifies DCO sign-off. Beat pre-commit's core team at their own game.

    Python 1

  4. awesome-mcp-servers awesome-mcp-servers Public

    Forked from punkpeye/awesome-mcp-servers

    My fork — contributed MisakaNet to the MCP ecosystem directory.

    1

  5. pensieve pensieve Public

    Python 1 1