Skip to main content
Glama
dk123579

Architectural Decision Log (ADL) System

by dk123579

Architectural Decision Log (ADL) System

A comprehensive system for managing architectural decisions with GraphQL backend, MCP server integration, and a web-based UI.

Architecture

  • GraphQL Backend (Port 4000): Provides data layer with CRUD operations for ADL entries

  • MCP HTTP Server (Port 5000): HTTP wrapper for MCP protocol, bridges UI and GraphQL

  • MCP Stdio Server: Model Context Protocol server for AI assistant integration

  • Web UI (Port 3000): React-based interface for managing ADL entries

Data Flow

UI (Port 3000) → MCP HTTP Server (Port 5000) → GraphQL Backend (Port 4000) → JSON Database AI Assistants → MCP Stdio Server → GraphQL Backend (Port 4000) → JSON Database

Features

  • Create, Read, Update, Delete architectural decision entries

  • Track decision metadata (author, timestamps, status)

  • Integration with SAP/LeanIX fact sheets

  • Table-based UI with filtering and sorting

  • Linux-compatible deployment

Data Model

Each ADL entry contains:

  • ID: Unique indexed key

  • Created: Creation timestamp

  • Last Edited: Last modification timestamp

  • Author: Decision author name

  • Title: Decision title

  • Decision: Detailed decision description

  • Fact Sheets: List of related SAP/LeanIX Fact Sheet names

  • Status: Proposed or Approved

Installation

# Install dependencies npm install # Start all services npm start # Or start services individually npm run start:graphql # GraphQL server on port 4000 npm run start:mcp # MCP server (stdio) npm run start:ui # UI server on port 3000

Docker Deployment (Linux)

# Build Docker image docker build -t adl-system . # Run container docker run -p 3000:3000 -p 4000:4000 -v $(pwd)/data:/app/data adl-system

Usage

Via UI

  1. Navigate to http://localhost:3000

  2. Use the web interface to manage ADL entries

Via MCP Server

The MCP server exposes the following tools:

  • adl_create: Create a new ADL entry

  • adl_read: Read ADL entries (all or by ID)

  • adl_update: Update an existing ADL entry

  • adl_delete: Delete an ADL entry

Via GraphQL

Access GraphQL Playground at http://localhost:4000/graphql

Example query:

query { adlEntries { id title status author } }

License

MIT

ADL-MCP

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dk123579/ADL-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server