# mario-andreschak/mcp-abap-abap-adt-api architecture

> Architecture diagram of the GitHub repository mario-andreschak/mcp-abap-abap-adt-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mario-andreschak/mcp-abap-abap-adt-api
- Repository: https://github.com/mario-andreschak/mcp-abap-abap-adt-api

## Overview

This is a local stdio MCP server exposing SAP ABAP ADT operations. An MCP client invokes validated tools through the runtime, which dispatches to handlers that perform SAP session and domain operations; large responses can be retrieved through local result paging. README documents the wider tool capabilities, while sampled source confirms runtime wiring and selected handler behavior. Unsampled handler relationships are limited to the documented runtime-to-SAP flow rather than inferred call chains.

Main entry points: [`src/server.ts`](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/server.ts) (Tool runtime), [`src/lib/adt-client.ts`](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/adt-client.ts) (ADT client), [`src/handlers/CodeAnalysisHandlers.ts`](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/CodeAnalysisHandlers.ts) (Code analysis), [`src/handlers/registry.ts`](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/registry.ts) (Handler registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["MCP runtime"]
  node_runtime["Tool runtime<br/>[server.ts]"]
  node_tool_schema["Tool schemas<br/>[schema.ts]"]
  node_tool_registry["Handler registry<br/>[registry.ts]"]
end

subgraph group_session["SAP connection"]
  node_session_handlers["Session control<br/>[AuthHandlers.ts]"]
  node_adt_client["ADT client<br/>[adt-client.ts]"]
end

subgraph group_objects["ABAP objects"]
  node_object_read["Object discovery"]
  node_object_source["Source and objects"]
  node_object_changes["Object changes"]
  node_object_access["Locks and deletion"]
end

subgraph group_operations["SAP operations"]
  node_code_analysis["Code analysis"]
  node_debugging["Debugging and trace<br/>[DebugHandlers.ts]"]
  node_transport["Transports"]
  node_query["Queries and DDIC<br/>[QueryHandlers.ts]"]
  node_git["SAP Git<br/>[GitHandlers.ts]"]
  node_analysis_tools["ATC and tests<br/>[AtcHandlers.ts]"]
end

subgraph group_support["Runtime support"]
  node_result_pages["Result paging<br/>[results.ts]"]
  node_source_cache[("Source snapshots<br/>[sourceCache.ts]")]
  node_http["Bounded HTTP<br/>[http.ts]"]
  node_errors["Error handling<br/>[errors.ts]"]
end

node_operator(("MCP client"))
node_sap["SAP ADT"]

node_operator -->|"invokes tools"| node_runtime
node_runtime -->|"validates inputs"| node_tool_schema
node_runtime -->|"registers handlers"| node_tool_registry
node_tool_registry -->|"registers tools"| node_session_handlers
node_runtime -->|"configures client"| node_adt_client
node_runtime -->|"reads pages"| node_result_pages
node_runtime -->|"owns cache"| node_source_cache
node_runtime -->|"configures requests"| node_http
node_session_handlers -->|"controls session"| node_adt_client
node_object_read -->|"reads ADT"| node_sap
node_object_source -->|"reads and writes"| node_sap
node_object_changes -->|"changes objects"| node_sap
node_object_access -->|"manages locks"| node_sap
node_code_analysis -->|"analyzes code"| node_sap
node_code_analysis -->|"uses snapshots"| node_source_cache
node_debugging -->|"debugs programs"| node_sap
node_transport -->|"manages transports"| node_sap
node_query -->|"runs queries"| node_sap
node_git -->|"uses SAP Git"| node_sap
node_analysis_tools -->|"runs ATC"| node_sap
node_adt_client -->|"sends ADT requests"| node_sap
node_runtime -->|"maps failures"| node_errors

click node_runtime "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/server.ts"
click node_tool_schema "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/schema.ts"
click node_tool_registry "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/registry.ts"
click node_session_handlers "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/AuthHandlers.ts"
click node_adt_client "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/adt-client.ts"
click node_object_read "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/DiscoveryHandlers.ts"
click node_object_source "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectSourceHandlers.ts"
click node_object_changes "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectManagementHandlers.ts"
click node_object_access "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectLockHandlers.ts"
click node_code_analysis "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/CodeAnalysisHandlers.ts"
click node_debugging "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/DebugHandlers.ts"
click node_transport "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/TransportHandlers.ts"
click node_query "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/QueryHandlers.ts"
click node_git "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/GitHandlers.ts"
click node_analysis_tools "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/AtcHandlers.ts"
click node_result_pages "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/results.ts"
click node_source_cache "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/sourceCache.ts"
click node_http "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/http.ts"
click node_errors "https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/errors.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runtime,node_tool_schema,node_tool_registry,node_operator toneBlue
class node_session_handlers,node_adt_client toneAmber
class node_object_read,node_object_source,node_object_changes,node_object_access toneMint
class node_code_analysis,node_debugging,node_transport,node_query,node_git,node_analysis_tools toneRose
class node_result_pages,node_source_cache,node_http,node_errors,node_sap toneIndigo
```

## Components

### MCP runtime

- [Tool runtime](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/server.ts): `src/server.ts`
- [Tool schemas](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/schema.ts): `src/schema.ts`
- [Handler registry](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/registry.ts): `src/handlers/registry.ts`

### SAP connection

- [Session control](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/AuthHandlers.ts): `src/handlers/AuthHandlers.ts`
- [ADT client](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/adt-client.ts): `src/lib/adt-client.ts`

### ABAP objects

- [Object discovery](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/DiscoveryHandlers.ts): `src/handlers/DiscoveryHandlers.ts`
- [Source and objects](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectSourceHandlers.ts): `src/handlers/ObjectSourceHandlers.ts`
- [Object changes](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectManagementHandlers.ts): `src/handlers/ObjectManagementHandlers.ts`
- [Locks and deletion](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/ObjectLockHandlers.ts): `src/handlers/ObjectLockHandlers.ts`

### SAP operations

- [Code analysis](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/CodeAnalysisHandlers.ts): `src/handlers/CodeAnalysisHandlers.ts`
- [Debugging and trace](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/DebugHandlers.ts): `src/handlers/DebugHandlers.ts`
- [Transports](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/TransportHandlers.ts): `src/handlers/TransportHandlers.ts`
- [Queries and DDIC](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/QueryHandlers.ts): `src/handlers/QueryHandlers.ts`
- [SAP Git](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/GitHandlers.ts): `src/handlers/GitHandlers.ts`
- [ATC and tests](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/handlers/AtcHandlers.ts): `src/handlers/AtcHandlers.ts`

### Runtime support

- [Result paging](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/results.ts): `src/lib/results.ts`
- [Source snapshots](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/sourceCache.ts): `src/lib/sourceCache.ts`
- [Bounded HTTP](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/http.ts): `src/lib/http.ts`
- [Error handling](https://github.com/mario-andreschak/mcp-abap-abap-adt-api/blob/main/src/lib/errors.ts): `src/lib/errors.ts`

### Other components

- **MCP client**
- **SAP ADT**

## Connections

- MCP client → Tool runtime: invokes tools (evidence: `README.md`)
- Tool runtime → Tool schemas: validates inputs (evidence: `src/server.ts`)
- Tool runtime → Handler registry: registers handlers (evidence: `src/server.ts`)
- Handler registry → Session control: registers tools (evidence: `src/handlers/registry.ts`)
- Tool runtime → ADT client: configures client (evidence: `src/server.ts`)
- Tool runtime → Result paging: reads pages (evidence: `src/server.ts`)
- Tool runtime → Source snapshots: owns cache (evidence: `src/server.ts`)
- Tool runtime → Bounded HTTP: configures requests (evidence: `src/server.ts`)
- Session control → ADT client: controls session (evidence: `src/handlers/AuthHandlers.ts`)
- Object discovery → SAP ADT: reads ADT (evidence: `README.md`)
- Source and objects → SAP ADT: reads and writes (evidence: `README.md`)
- Object changes → SAP ADT: changes objects (evidence: `README.md`)
- Locks and deletion → SAP ADT: manages locks (evidence: `README.md`)
- Code analysis → SAP ADT: analyzes code (evidence: `README.md`)
- Code analysis → Source snapshots: uses snapshots (evidence: `src/handlers/CodeAnalysisHandlers.ts`)
- Debugging and trace → SAP ADT: debugs programs (evidence: `README.md`)
- Transports → SAP ADT: manages transports (evidence: `README.md`)
- Queries and DDIC → SAP ADT: runs queries (evidence: `src/handlers/QueryHandlers.ts`)
- SAP Git → SAP ADT: uses SAP Git (evidence: `README.md`)
- ATC and tests → SAP ADT: runs ATC (evidence: `README.md`)
- ADT client → SAP ADT: sends ADT requests (evidence: `README.md`)
- Tool runtime → Error handling: maps failures (evidence: `src/server.ts`)
