# KRouter

> KRouter is an open-source MCP server for knowledge and memory. Local Markdown memory that recalls past decisions and cites the page it came from. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, Windows, CLI, self-hosted
- **Website:** https://398894496-arch.github.io/KRouter/
- **Repository:** https://github.com/398894496-arch/krouter
- **MCP Registry name:** io.github.398894496-arch/krouter
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

KRouter stores a person's notes as plain Markdown on their own machine and brings them up when relevant, so an agent does not start each task blind. If a user says they plan to move some files and an earlier note says not to, the agent surfaces that note and names the page and section it came from. A lesson learned on one task can be offered on another, and a change of mind replaces the old answer.

Recall is a local lookup with no model and nothing sent elsewhere. For one person it needs no API key or server; a team server and model distilling are optional. It targets coding agents such as Claude Code, Codex, Cursor, DeepSeek Harness, Hermes and OpenClaw, and any MCP app including Claude Desktop. It installs as an mcpb bundle, with benchmarks for answering honestly when it does not know.

## Features

- **Page citations:** Each recalled answer names its source page.
- **Local lookup:** No model call and nothing leaves the machine.
- **Change-of-mind handling:** Newer decisions replace old ones.
- **Connected recall:** Brings related notes along.
- **Optional team server:** Not needed for single use.

## Good for

- Stop an agent repeating a vetoed action
- Carry lessons across tasks
- Keep a personal preferences page
- Share memory across a team

## Install

### Claude Code (Terminal)

```sh
claude mcp add krouter -- npx -y https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "krouter": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "krouter": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "krouter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "krouter": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "krouter": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need an API key?

Not for one person.

### Where is data kept?

As Markdown on the user's machine.

### Which agents work?

Claude Code, Codex, Cursor, DeepSeek Harness, Hermes, OpenClaw and MCP apps.

### Does it admit gaps?

It is designed to say when it does not know.

### Is KRouter free?

Yes. KRouter is open source, so you can use and self-host it for free.

### How do I add KRouter to Claude Code?

Run this command in your terminal: claude mcp add krouter -- npx -y https://github.com/398894496-arch/KRouter/releases/download/v2.1.2/KRouter.mcpb

### What are the best alternatives to KRouter?

The closest alternatives to KRouter are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/krouter
