# kogcat-mcp

Local-first calibration layer that highlights blind spots and counterexamples straight from your own notes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: KogCat
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/KogCat/cc-kogcat
- Updated: 2026-06-24
- HTML: https://affpapa.org/en/nevibecode/mcp/kogcat-mcp

## What it does

This MCP server links your coding agent to an on-device repository of notes and decisions. It is built specifically for trade-offs and reviews where bad assumptions prove expensive. When evaluating difficult questions, the client calls tools like `calibrate`, `calibrate_review`, `edges`, `search`, and the `memory_*` family to spot discrepancies between model output and your recorded experience.

The service runs locally via a sidecar process. On its initial launch, it pulls down a 40 MB engine alongside an embedding model of roughly 90 MB. No private notes or calibration results leave the host environment.

Running this tool requires macOS on Apple Silicon or Windows x86_64; Linux and Intel Mac hardware are unsupported. You must also have `uv` installed and Python 3 present on your system `PATH`.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- surface blind spots in design tradeoffs using private notes
- retrieve local counterexamples before executing risky architectural changes
- inspect cached memory nodes and relationships during development sessions
- validate strategic technical decisions without cloud data leakage

## Example prompts
- Use KogCat to spot potential blind spots in this database migration plan
- Run a calibration check against my local knowledge base for this design choice
- Consult KogCat to verify if we documented any counterexamples for this pattern

## Similar
- [Mnemosyne OS](https://affpapa.org/en/nevibecode/mcp/mnemosyne-os.md) — MCP server · ★ 20
- [docket](https://affpapa.org/en/nevibecode/mcp/docket.md) — MCP server · ★ 10
- [mindmap-mcp-server](https://affpapa.org/en/nevibecode/mcp/mindmap-mcp-server.md) — MCP server · ★ 6
- [stellavault](https://affpapa.org/en/nevibecode/mcp/stellavault.md) — MCP server · ★ 5
- [Magnemo](https://affpapa.org/en/nevibecode/mcp/magnemo.md) — MCP server · ★ 4
- [Granoflow](https://affpapa.org/en/nevibecode/mcp/granoflow.md) — MCP server

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