Skip to main content
Glama
@mhdd_24/adr-mcp
by Mhdd-24

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

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

Option B — npx

npx @mhdd_24/adr-mcp

Option 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.js

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

ADR directory


Tools

Tool

Description

adr_status

Show ADR directory.

adr_list

List ADR files.

adr_new

Generate a new ADR markdown stub.


License

ISC

Available Tools

3 tools
adr_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

    B3.1/5.0

    Scored across 3 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Three tools is well-scoped for a focused ADR management server, covering the essential actions without unnecessary complexity.

    Completeness3/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers