# dnic-dev/bw-modeling-mcp architecture

> Architecture diagram of the GitHub repository dnic-dev/bw-modeling-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dnic-dev/bw-modeling-mcp
- Repository: https://github.com/dnic-dev/bw-modeling-mcp

## Overview

bw-modeling-mcp is an MCP server through which AI clients inspect and change live SAP BW systems. The main workflow is client request → MCP dispatch and platform checks → a domain tool → BW APIs, with results returned through the server. Tools cover object modeling, query design, data lineage and metadata, and operational data loads and monitoring. Shared client, platform, and request-context layers support BW access and hosted per-user identity. The README documents hosted OAuth and destinations; their wiring is not shown in the sampled source, so those links are omitted.

Main entry points: [`src/index.ts`](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/index.ts) (MCP server), [`src/bw-client.ts`](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/bw-client.ts) (BW client), [`src/http.ts`](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/http.ts) (HTTP transport), [`src/tools/query_update.ts`](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_update.ts) (Query updates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry"]
  node_server["MCP server<br/>[index.ts]"]
  node_stdio["stdio transport<br/>[stdio.ts]"]
  node_http["HTTP transport<br/>[http.ts]"]
  node_scopes["Tool scopes<br/>[scopes.ts]"]
end

subgraph group_shared["Shared runtime"]
  node_platform["Platform detection<br/>[platform.ts]"]
  node_request["Request context<br/>[request-context.ts]"]
  node_client["BW client<br/>[bw-client.ts]"]
end

subgraph group_modeling["BW modeling"]
  node_modeling_tools["Modeling objects"]
  node_activation["Activation<br/>[activation.ts]"]
  node_transform["Transformations and DTPs<br/>[transformation.ts]"]
  node_composite["CompositeProviders"]
  node_elements["Reusable elements<br/>[elem_write.ts]"]
end

subgraph group_query["Queries and reporting"]
  node_query_tools["Query tools<br/>[query.ts]"]
  node_query_update["Query updates<br/>[query_update.ts]"]
  node_query_cells["Query cells<br/>[query_cells.ts]"]
  node_query_characteristics["Query characteristics"]
  node_reporting["Reporting<br/>[reporting.ts]"]
end

subgraph group_insight["Metadata and lineage"]
  node_search["Search<br/>[search.ts]"]
  node_metadata["Metadata readers<br/>[metadata_tables.ts]"]
  node_metadata_sql["Metadata SQL<br/>[metadata_sql.ts]"]
  node_lineage["Data flow<br/>[dataflow.ts]"]
end

subgraph group_operations["BW operations"]
  node_monitoring["Request monitoring<br/>[request_monitor.ts]"]
  node_chains["Process chains<br/>[processchain.ts]"]
  node_push["Data push<br/>[push.ts]"]
end

node_ai(("AI client"))
node_bw["SAP BW system"]
node_destination["BTP destination"]
node_oauth["XSUAA OAuth"]

node_ai -->|"sends requests"| node_stdio
node_ai -->|"sends requests"| node_http
node_stdio -->|"starts"| node_server
node_http -->|"routes requests"| node_server
node_http -->|"sets context"| node_request
node_http -->|"checks access"| node_scopes
node_server -->|"checks availability"| node_platform
node_server -->|"dispatches tools"| node_modeling_tools
node_server -->|"dispatches tools"| node_query_tools
node_server -->|"dispatches tools"| node_query_update
node_server -->|"dispatches tools"| node_query_cells
node_server -->|"dispatches tools"| node_query_characteristics
node_server -->|"dispatches tools"| node_reporting
node_server -->|"dispatches tools"| node_search
node_server -->|"dispatches tools"| node_metadata
node_server -->|"dispatches tools"| node_lineage
node_server -->|"dispatches tools"| node_monitoring
node_server -->|"dispatches tools"| node_chains
node_server -->|"dispatches tools"| node_push
node_modeling_tools -->|"uses BW APIs"| node_client
node_activation -->|"calls"| node_client
node_transform -->|"calls"| node_client
node_transform -->|"uses"| node_activation
node_composite -->|"calls"| node_client
node_elements -->|"calls"| node_client
node_query_tools -->|"calls"| node_client
node_query_update -->|"reuses query helpers"| node_query_tools
node_query_update -->|"calls"| node_client
node_query_cells -->|"uses document helpers"| node_query_update
node_query_characteristics -->|"uses document helpers"| node_query_update
node_reporting -->|"calls"| node_client
node_search -->|"queries metadata"| node_metadata_sql
node_search -->|"reads provider details"| node_metadata
node_metadata -->|"runs SQL reads"| node_metadata_sql
node_metadata_sql -->|"calls ADT API"| node_client
node_metadata -->|"calls BW APIs"| node_client
node_lineage -->|"reads BW lineage"| node_client
node_monitoring -->|"calls manage API"| node_client
node_chains -->|"calls BW APIs"| node_client
node_push -->|"calls Push API"| node_client
node_client -->|"connects to"| node_bw
node_oauth -.->|"protects hosted access"| node_http
node_http -.->|"uses hosted destination"| node_destination
node_request -->|"supplies active client"| node_client

click node_server "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/index.ts"
click node_stdio "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/stdio.ts"
click node_http "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/http.ts"
click node_scopes "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/scopes.ts"
click node_platform "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/platform.ts"
click node_request "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/request-context.ts"
click node_client "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/bw-client.ts"
click node_modeling_tools "https://github.com/dnic-dev/bw-modeling-mcp/tree/main/src/tools"
click node_activation "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/activation.ts"
click node_transform "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/transformation.ts"
click node_composite "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/composite_provider.ts"
click node_elements "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/elem_write.ts"
click node_query_tools "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query.ts"
click node_query_update "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_update.ts"
click node_query_cells "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_cells.ts"
click node_query_characteristics "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_characteristic.ts"
click node_reporting "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/reporting.ts"
click node_search "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/search.ts"
click node_metadata "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/metadata_tables.ts"
click node_metadata_sql "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/metadata_sql.ts"
click node_lineage "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/dataflow.ts"
click node_monitoring "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/request_monitor.ts"
click node_chains "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/processchain.ts"
click node_push "https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/push.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_server,node_stdio,node_http,node_scopes,node_ai toneBlue
class node_platform,node_request,node_client toneAmber
class node_modeling_tools,node_activation,node_transform,node_composite,node_elements toneMint
class node_query_tools,node_query_update,node_query_cells,node_query_characteristics,node_reporting toneRose
class node_search,node_metadata,node_metadata_sql,node_lineage,node_bw,node_destination,node_oauth toneIndigo
class node_monitoring,node_chains,node_push toneTeal
```

## Components

### MCP entry

- [MCP server](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/index.ts): `src/index.ts`
- [stdio transport](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/stdio.ts): `src/stdio.ts`
- [HTTP transport](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/http.ts): `src/http.ts`
- [Tool scopes](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/scopes.ts): `src/scopes.ts`

### Shared runtime

- [Platform detection](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/platform.ts): `src/platform.ts`
- [Request context](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/request-context.ts): `src/request-context.ts`
- [BW client](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/bw-client.ts): `src/bw-client.ts`

### BW modeling

- [Modeling objects](https://github.com/dnic-dev/bw-modeling-mcp/tree/main/src/tools): `src/tools`
- [Activation](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/activation.ts): `src/tools/activation.ts`
- [Transformations and DTPs](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/transformation.ts): `src/tools/transformation.ts`
- [CompositeProviders](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/composite_provider.ts): `src/tools/composite_provider.ts`
- [Reusable elements](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/elem_write.ts): `src/tools/elem_write.ts`

### Queries and reporting

- [Query tools](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query.ts): `src/tools/query.ts`
- [Query updates](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_update.ts): `src/tools/query_update.ts`
- [Query cells](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_cells.ts): `src/tools/query_cells.ts`
- [Query characteristics](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/query_characteristic.ts): `src/tools/query_characteristic.ts`
- [Reporting](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/reporting.ts): `src/tools/reporting.ts`

### Metadata and lineage

- [Search](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/search.ts): `src/tools/search.ts`
- [Metadata readers](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/metadata_tables.ts): `src/tools/metadata_tables.ts`
- [Metadata SQL](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/metadata_sql.ts): `src/tools/metadata_sql.ts`
- [Data flow](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/dataflow.ts): `src/tools/dataflow.ts`

### BW operations

- [Request monitoring](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/request_monitor.ts): `src/tools/request_monitor.ts`
- [Process chains](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/processchain.ts): `src/tools/processchain.ts`
- [Data push](https://github.com/dnic-dev/bw-modeling-mcp/blob/main/src/tools/push.ts): `src/tools/push.ts`

### Other components

- **AI client**
- **SAP BW system**
- **BTP destination**
- **XSUAA OAuth**

## Connections

- AI client → stdio transport: sends requests (evidence: `src/stdio.ts`)
- AI client → HTTP transport: sends requests (evidence: `README.md`)
- stdio transport → MCP server: starts (evidence: `src/stdio.ts`)
- HTTP transport → MCP server: routes requests (evidence: `src/http.ts`)
- HTTP transport → Request context: sets context (evidence: `src/http.ts`)
- HTTP transport → Tool scopes: checks access (evidence: `src/http.ts`)
- MCP server → Platform detection: checks availability (evidence: `src/index.ts`)
- MCP server → Modeling objects: dispatches tools (evidence: `src/index.ts`)
- MCP server → Query tools: dispatches tools (evidence: `src/index.ts`)
- MCP server → Query updates: dispatches tools (evidence: `src/index.ts`)
- MCP server → Query cells: dispatches tools (evidence: `src/index.ts`)
- MCP server → Query characteristics: dispatches tools (evidence: `src/index.ts`)
- MCP server → Reporting: dispatches tools (evidence: `src/index.ts`)
- MCP server → Search: dispatches tools (evidence: `src/index.ts`)
- MCP server → Metadata readers: dispatches tools (evidence: `src/index.ts`)
- MCP server → Data flow: dispatches tools (evidence: `README.md`)
- MCP server → Request monitoring: dispatches tools (evidence: `README.md`)
- MCP server → Process chains: dispatches tools (evidence: `README.md`)
- MCP server → Data push: dispatches tools (evidence: `src/index.ts`)
- Modeling objects → BW client: uses BW APIs (evidence: `README.md`)
- Activation → BW client: calls (evidence: `src/tools/activation.ts`)
- Transformations and DTPs → BW client: calls (evidence: `src/tools/transformation.ts`)
- Transformations and DTPs → Activation: uses (evidence: `src/tools/transformation.ts`)
- CompositeProviders → BW client: calls (evidence: `src/tools/composite_provider.ts`)
- Reusable elements → BW client: calls (evidence: `src/tools/elem_write.ts`)
- Query tools → BW client: calls (evidence: `src/tools/query.ts`)
- Query updates → Query tools: reuses query helpers (evidence: `src/tools/query_update.ts`)
- Query updates → BW client: calls (evidence: `src/tools/query_update.ts`)
- Query cells → Query updates: uses document helpers (evidence: `src/tools/query_cells.ts`)
- Query characteristics → Query updates: uses document helpers (evidence: `src/tools/query_characteristic.ts`)
- Reporting → BW client: calls (evidence: `src/tools/reporting.ts`)
- Search → Metadata SQL: queries metadata (evidence: `src/tools/search.ts`)
- Search → Metadata readers: reads provider details (evidence: `src/tools/search.ts`)
- Metadata readers → Metadata SQL: runs SQL reads (evidence: `src/tools/metadata_tables.ts`)
- Metadata SQL → BW client: calls ADT API (evidence: `src/tools/metadata_sql.ts`)
- Metadata readers → BW client: calls BW APIs (evidence: `src/tools/metadata_tables.ts`)
- Data flow → BW client: reads BW lineage (evidence: `README.md`)
- Request monitoring → BW client: calls manage API (evidence: `README.md`)
- Process chains → BW client: calls BW APIs (evidence: `README.md`)
- Data push → BW client: calls Push API (evidence: `README.md`)
- BW client → SAP BW system: connects to (evidence: `README.md`)
- XSUAA OAuth → HTTP transport: protects hosted access (evidence: `README.md`)
- HTTP transport → BTP destination: uses hosted destination (evidence: `README.md`)
- Request context → BW client: supplies active client (evidence: `src/request-context.ts`)
