Nauro — Claude Code MCP server: what it does, how to install
Stores approved project choices and discarded alternatives in plain Markdown. Keeps AI agents aligned with earlier technical reasoning.
claude mcp add nauro -- uvx nauroWhat Nauro does
Nauro maintains a log of human-approved architectural decisions, noting both the reasoning and discarded alternatives. When agents begin new sessions, the server surfaces these historical arguments. That keeps assistants from resurfacing proposals the team already rejected. Everything stays on your local disk as plain Markdown files.
Context retrieval is advisory. The model cannot alter the record autonomously: every new or modified choice demands explicit confirmation from the developer. During adoption, an existing AGENTS.md file stays intact, and its # Manual section remains untouched across synchronization runs.
Setup requires uv or Python 3.10+. If you configure global MCP wiring in Cursor, you must provide a permanent absolute path to the nauro executable, or the connection fails.
What it helps with
- record software architecture choices alongside rejected alternatives
- keep historical reasoning intact across separate agent sessions
- prevent assistants from suggesting previously abandoned technical paths
- safeguard manual sections inside
AGENTS.mdfrom being overwritten
Example prompts for the agent
- /nauro-adopt
- Check prior decisions to see why we rejected passive expense tracking.
- Log our move to PostgreSQL and document the rejected SQLite alternative.
How to install Nauro
Platform CLI
claude mcp add nauro -- uvx naurouvx runs the command named after the package; if the README names another one, use uvx --from nauro <command>
Platform CLI
codex mcp add nauro -- uvx naurouvx runs the command named after the package; if the README names another one, use uvx --from nauro <command>
Config file
{
"mcpServers": {
"nauro": {
"command": "uvx",
"args": [
"nauro"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from nauro <command>
Config file
{
"servers": {
"nauro": {
"type": "stdio",
"command": "uvx",
"args": [
"nauro"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from nauro <command>
Platform CLI
gemini mcp add nauro uvx naurouvx runs the command named after the package; if the README names another one, use uvx --from nauro <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 Nauro
How to install Nauro in Claude Code?
Run claude mcp add nauro -- uvx nauro. Make sure uv or Python 3.10+ is available on your machine.
What does Nauro do?
It tracks agreed project decisions and rejected paths in local Markdown, bringing that rationale back into subsequent coding sessions.
Can an AI agent modify decisions automatically?
No. Historical data is strictly advisory, meaning any entry or revision requires direct approval from the user.
