mcp-adr-analysis-server — Claude Code MCP server: install
Checks architectural decisions in ADRs against code, masks sensitive content, and keeps decision context across sessions. Useful for spotting stale records.
claude mcp add --env PROJECT_PATH=<PROJECT_PATH> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env EXECUTION_MODE=<EXECUTION_MODE> --env ADR_DIRECTORY=<ADR_DIRECTORY> --transport stdio mcp-adr-analysis-server -- npx -y mcp-adr-analysis-serverWhat mcp-adr-analysis-server does
The server checks whether architectural decisions still match the code and infrastructure. It can also find and mask secrets and personal data, locate code files related to ADRs, and track sessions and tool usage. Tree-sitter supports code analysis; the listed capabilities also include technology detection and deployment-readiness checks.
Installation requires Node.js 20.0.0 or later and npm 9.0.0 or later. Internet access is needed during npm install to compile Tree-sitter native modules, so installation needs network access. The Claude Code command sets OPENROUTER_API_KEY; an alternative command also accepts PROJECT_PATH, EXECUTION_MODE, and ADR_DIRECTORY.
What it helps with
- check ADR decisions against the current code
- find and mask secrets and personal data
- locate code files related to ADRs
- retain architectural decision context between sessions
- check deployment readiness
Example prompts for the agent
- Check whether the ADR decisions still match the code.
- Find and mask secrets and personal data in the project.
- Locate the code files related to these ADRs.
How to install mcp-adr-analysis-server
Platform CLI
claude mcp add --env PROJECT_PATH=<PROJECT_PATH> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env EXECUTION_MODE=<EXECUTION_MODE> --env ADR_DIRECTORY=<ADR_DIRECTORY> --transport stdio mcp-adr-analysis-server -- npx -y mcp-adr-analysis-serverReplace <…> with your own values
Platform CLI
codex mcp add mcp-adr-analysis-server --env PROJECT_PATH=<PROJECT_PATH> --env OPENROUTER_API_KEY=<OPENROUTER_API_KEY> --env EXECUTION_MODE=<EXECUTION_MODE> --env ADR_DIRECTORY=<ADR_DIRECTORY> -- npx -y mcp-adr-analysis-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-adr-analysis-server": {
"command": "npx",
"args": [
"-y",
"mcp-adr-analysis-server"
],
"env": {
"PROJECT_PATH": "<PROJECT_PATH>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"EXECUTION_MODE": "<EXECUTION_MODE>",
"ADR_DIRECTORY": "<ADR_DIRECTORY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-adr-analysis-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-adr-analysis-server"
],
"env": {
"PROJECT_PATH": "<PROJECT_PATH>",
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"EXECUTION_MODE": "<EXECUTION_MODE>",
"ADR_DIRECTORY": "<ADR_DIRECTORY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PROJECT_PATH=<PROJECT_PATH> -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -e EXECUTION_MODE=<EXECUTION_MODE> -e ADR_DIRECTORY=<ADR_DIRECTORY> mcp-adr-analysis-server npx -y mcp-adr-analysis-serverReplace <…> with your own values
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 mcp-adr-analysis-server
How do I install mcp-adr-analysis-server in Claude Code?
Run claude mcp add mcp-adr-analysis-server -e OPENROUTER_API_KEY=<OPENROUTER_API_KEY> -- npx -y mcp-adr-analysis-server. A separate command is available for configuring project-specific parameters.
What does mcp-adr-analysis-server do?
It checks ADRs against code and infrastructure, masks sensitive content, and tracks sessions and tool usage.
What does mcp-adr-analysis-server need to run?
It requires Node.js 20.0.0 or later, npm 9.0.0 or later, and an MCP-compatible client. npm installation also needs internet access to compile native modules.
