kogcat-mcp — Claude Code MCP server: what it does, how to install
Local-first calibration layer that highlights blind spots and counterexamples straight from your own notes.
claude mcp add kogcat-mcp -- uvx kogcat-mcpWhat kogcat-mcp 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.
What it helps with
- 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 for the agent
- 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
How to install kogcat-mcp
Platform CLI
claude mcp add kogcat-mcp -- uvx kogcat-mcpuvx runs the command named after the package; if the README names another one, use uvx --from kogcat-mcp <command>
Platform CLI
codex mcp add kogcat-mcp -- uvx kogcat-mcpuvx runs the command named after the package; if the README names another one, use uvx --from kogcat-mcp <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add kogcat-mcp uvx kogcat-mcpuvx runs the command named after the package; if the README names another one, use uvx --from kogcat-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about kogcat-mcp
How to install kogcat-mcp in Claude Code?
Run claude mcp add kogcat-mcp -- uvx kogcat-mcp in your terminal.
What does kogcat-mcp do?
It provides tools for inspecting local notes, uncovering blind spots, and checking counterexamples when making complex technical judgments.
Which operating systems are supported?
It works on Apple Silicon macOS and Windows x86_64, requiring uv and Python 3 on your PATH.
