@mhdd_24/adr-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@mhdd_24/adr-mcp Create a new ADR for migrating to PostgreSQL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@mhdd_24/adr-mcp
Architecture Decision Records management.
Same architecture as @mhdd_24/sublime-mcp.
Full documentation: docs/WIKI.md
How it works (30 seconds)
You (chat) → MCP client → adr-mcp → ADR APIs / CLIs / local toolsRelated MCP server: AdrMcp
Prerequisites
Requirement | Notes |
Node.js 18+ | ESM TypeScript MCP server |
Credentials / CLIs | See environment variables below |
Install
Option A — npm (after publish)
npm install -g @mhdd_24/adr-mcpOption B — npx
npx @mhdd_24/adr-mcpOption C — clone and build
git clone https://github.com/Mhdd-24/ADR-MCP.git
cd ADR-MCP
npm install
npm run build
node dist/index.jsConfigure Cursor
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"adr": {
"command": "npx",
"args": ["-y", "@mhdd_24/adr-mcp"],
"env": {
"ADR_DIR": "..."
}
}
}
}Local development:
{
"command": "node",
"args": ["/absolute/path/to/ADR-MCP/dist/index.js"]
}Environment variables
Variable | Description |
| ADR directory |
Tools
Tool | Description |
| Show ADR directory. |
| List ADR files. |
| Generate a new ADR markdown stub. |
License
ISC
Available Tools
3 toolsadr_listB
List ADR files.
Inputs: dir.
adr_newC
Generate a new ADR markdown stub.
Inputs: title (required), context.
adr_statusC
Show ADR directory.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
adr_status and adr_list overlap in purpose, both providing visibility into ADRs (directory vs. files), which could confuse an agent. adr_new is clearly distinct as a creation action.
All tools share the adr_ prefix, making the pattern predictable. However, suffixes mix nouns and verbs (status, list, new) rather than following a strict verb_noun convention.
Three tools is well-scoped for a focused ADR management server, covering the essential actions without unnecessary complexity.
Creating and listing ADRs are covered, but there is no tool to view the content of a specific ADR, nor update or delete records. This leaves a notable gap in the lifecycle.
Maintenance
Related MCP Connectors
Spec-driven delivery: plans, solutions, ADRs, UX docs, tasks, rules and skills for AI agents.
Generate architecture docs, implementation plans, and dev tickets from your project requirements.
Ask what your product does, triage requests and publish the changelog, from a map of your code.
Runnable, versioned lists for agents: tools, prompts and lists as resources. Git under the hood.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to create, manage, diagram, and export Architecture Decision Records (ADRs) directly from conversation.15MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that turns a folder of Markdown ADRs into live tools for AI agents: search, author, validate, link, and trace architectural decisions, with preview-by-default writes.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to record and retrieve architectural decision records, check precedent before making decisions, and avoid repeating past mistakes or contradicting settled choices.39 PyPI4Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to create, list, and read numbered Markdown Architecture Decision Records, and to review designs against pluggable domain rule packs (general, insurance, banking, healthcare, agentic AI) that return PASS/FAIL/UNKNOWN verdicts with evidence. Supports custom rule packs supplied via a local directory of YAML files.MIT