# mcp-adr-analysis-server

Checks architectural decisions in ADRs against code, masks sensitive content, and keeps decision context across sessions. Useful for spotting stale records.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 35
- Author: tosin2013
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tosin2013/mcp-adr-analysis-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-adr-analysis-server

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PROJECT_PATH`, `OPENROUTER_API_KEY`, `EXECUTION_MODE`, `ADR_DIRECTORY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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