Back to Home
tosin2013 icon

mcp-adr-analysis-server

by tosin2013

Overview

AI-powered Architectural Decision Record (ADR) analysis, generation, and validation server. It integrates advanced prompting techniques (GKP, APE, Reflexion) to assist with software architecture, development workflows, deployment, security analysis, rule generation, and project planning.

Installation

Run Command
node dist/src/index.js

Environment Variables

  • OPENROUTER_API_KEY
  • AI_MODEL
  • PROJECT_PATH
  • ADR_DIRECTORY
  • LOG_LEVEL
  • AI_BASE_URL
  • AI_SITE_URL
  • AI_SITE_NAME
  • EXECUTION_MODE
  • TS_PARSER_DIR
  • USER

Security Notes

The server uses `child_process.execSync` and `child_process.exec` extensively (e.g., for git operations, npm commands, gitleaks, kubectl/oc/docker commands, shell scripts from ADRs/patterns). This pattern is highly susceptible to command injection vulnerabilities if AI-generated or user-provided inputs are not perfectly sanitized. It also creates and runs temporary files from content for Tree-sitter analysis, which can be risky if malicious content is processed. Direct execution of arbitrary shell commands within a server process is a critical security risk.

Similar Servers

Stats

Interest Score40
Security Score2
Cost ClassHigh
Avg Tokens3000
Stars15
Forks6
Last Update2025-12-11

Tags

architectural-analysisadr-managementai-agentsdevopsdeploymentresearchcode-qualitysecurityprompt-engineeringknowledge-graphmemory-managementautomationtypescriptnode.js