# misakanet

Searches evidence-rated write-ups of past failures by error text, so your agent stops re-debugging the same break.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 544
- Author: Ikalus1988
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Ikalus1988/MisakaNet
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/misakanet

## What it does

MisakaNet is a lesson base about failures that an agent reaches over MCP. An error shows up, the agent sends its text to search, and gets back a fix someone already checked, along with an evidence rating. Every lesson is a Markdown file in the repo, reviewed the way code is.

Retrieval runs on BM25 from the Python standard library. There is no vector store and no embedding model, so nothing extra has to be hosted — Python 3.10 or newer is enough. Lessons carry levels, from a raw draft up to one confirmed by reuse across separate clients. When nothing matches, the server replies `no_match` and hands back a form for a new write-up.

The public endpoint `https://misakanet.org/mcp` allows anonymous reads, so no account or token is involved. For a local run the command is `uvx misakanet` — without `uvx` on the machine, adding the server just fails.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add misakanet -- uvx misakanet
```
uvx runs the command named after the package; if the README names another one, use uvx --from misakanet <command>

### Codex

**Platform CLI**
```bash
codex mcp add misakanet -- uvx misakanet
```
uvx runs the command named after the package; if the README names another one, use uvx --from misakanet <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "misakanet": {
            "command": "uvx",
            "args": [
                "misakanet"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from misakanet <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "misakanet": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "misakanet"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from misakanet <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add misakanet uvx misakanet
```
uvx runs the command named after the package; if the README names another one, use uvx --from misakanet <command>

## When to use it
- look up a fix by pasting the error text
- reuse a verified fix instead of debugging from scratch
- tell a reviewed lesson from a draft by its evidence level
- turn a fresh failure into a lesson for the next agent
- wire failure search into an agent over MCP

## Example prompts
- Search misakanet for `database is locked`
- Look up in misakanet why `pip install` times out behind a proxy
- Check this test failure against misakanet

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md