# mf-dynatrace/dt-mcp-workspace architecture

> Architecture diagram of the GitHub repository mf-dynatrace/dt-mcp-workspace, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mf-dynatrace/dt-mcp-workspace
- Repository: https://github.com/mf-dynatrace/dt-mcp-workspace

## Overview

Dynatrace MCP Workspace is a reusable collection of AI-client instructions, domain skills, and reference templates for investigating and operating Dynatrace environments. The principal workflow is an engineer asking a configured AI client a question, with the workspace supplying Dynatrace guidance; optional analytics scripts extract timeseries queries from dashboards or notebooks and can pass query sets to Davis analyzers. The README documents workspace setup and capabilities, while the sampled code verifies the analytics calls. The README’s client-to-workspace wiring and unsampled skill internals are not shown, so those links are omitted.

Main entry points: [`skills/dt-obs-analytics/scripts/run-analyzer.js`](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/run-analyzer.js) (Davis analyzer runner), [`skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js`](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js) (Dashboard extractor), [`skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js`](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js) (Notebook extractor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace guidance"]
  node_workspace_config["MCP configuration<br/>[.mcp.json]"]
  node_dql_skill["DQL guidance<br/>[SKILL.md]"]
  node_reference_templates["Tenant references"]
  node_dashboards["Dashboard guidance<br/>[SKILL.md]"]
  node_notebooks["Notebook guidance<br/>[SKILL.md]"]
end

subgraph group_analytics["Timeseries analytics"]
  node_dashboard_extract["Dashboard extractor"]
  node_notebook_extract["Notebook extractor"]
  node_analyzer_runner["Davis analyzer runner<br/>[run-analyzer.js]"]
end

subgraph group_operations["Observability operations"]
  node_alerting["Alerting guidance<br/>[SKILL.md]"]
  node_frontends["Frontend observability<br/>[SKILL.md]"]
  node_problems["Problem analysis<br/>[SKILL.md]"]
  node_cloud_obs["Cloud observability<br/>[SKILL.md]"]
end

subgraph group_platform["Platform capabilities"]
  node_migration["Migration guidance<br/>[SKILL.md]"]
  node_js_runtime["JavaScript runtime<br/>[SKILL.md]"]
  node_mobile_setup["Mobile setup"]
end

node_engineer(("Engineer"))
node_ai_client["AI client"]
node_dynatrace_documents["Dynatrace documents"]
node_davis_analyzers["Davis analyzers"]

node_engineer -->|"asks questions"| node_ai_client
node_dashboard_extract -->|"downloads content"| node_dynatrace_documents
node_notebook_extract -->|"downloads content"| node_dynatrace_documents
node_analyzer_runner -->|"executes and polls"| node_davis_analyzers
node_dashboard_extract -.->|"provides query set"| node_analyzer_runner
node_notebook_extract -.->|"provides query set"| node_analyzer_runner

click node_workspace_config "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/.mcp.json"
click node_dql_skill "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-dql-essentials/SKILL.md"
click node_reference_templates "https://github.com/mf-dynatrace/dt-mcp-workspace/tree/main/reference"
click node_dashboard_extract "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js"
click node_notebook_extract "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js"
click node_analyzer_runner "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/run-analyzer.js"
click node_dashboards "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-app-dashboards/SKILL.md"
click node_notebooks "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-app-notebooks/SKILL.md"
click node_alerting "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-alerting/SKILL.md"
click node_frontends "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-frontends/SKILL.md"
click node_problems "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-problems/SKILL.md"
click node_cloud_obs "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-aws/SKILL.md"
click node_migration "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-migration/SKILL.md"
click node_js_runtime "https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-js-runtime/SKILL.md"
click node_mobile_setup "https://github.com/mf-dynatrace/dt-mcp-workspace/tree/main/skills/dt-setup-ios"

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_workspace_config,node_dql_skill,node_reference_templates,node_dashboards,node_notebooks,node_ai_client toneBlue
class node_dashboard_extract,node_notebook_extract,node_analyzer_runner toneAmber
class node_alerting,node_frontends,node_problems,node_cloud_obs toneMint
class node_migration,node_js_runtime,node_mobile_setup toneRose
class node_engineer,node_dynatrace_documents,node_davis_analyzers toneIndigo
```

## Components

### Workspace guidance

- [MCP configuration](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/.mcp.json): `.mcp.json`
- [DQL guidance](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-dql-essentials/SKILL.md): `skills/dt-dql-essentials/SKILL.md`
- [Tenant references](https://github.com/mf-dynatrace/dt-mcp-workspace/tree/main/reference): `reference`
- [Dashboard guidance](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-app-dashboards/SKILL.md): `skills/dt-app-dashboards/SKILL.md`
- [Notebook guidance](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-app-notebooks/SKILL.md): `skills/dt-app-notebooks/SKILL.md`

### Timeseries analytics

- [Dashboard extractor](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js): `skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js`
- [Notebook extractor](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js): `skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js`
- [Davis analyzer runner](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-analytics/scripts/run-analyzer.js): `skills/dt-obs-analytics/scripts/run-analyzer.js`

### Observability operations

- [Alerting guidance](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-alerting/SKILL.md): `skills/dt-alerting/SKILL.md`
- [Frontend observability](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-frontends/SKILL.md): `skills/dt-obs-frontends/SKILL.md`
- [Problem analysis](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-problems/SKILL.md): `skills/dt-obs-problems/SKILL.md`
- [Cloud observability](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-obs-aws/SKILL.md): `skills/dt-obs-aws/SKILL.md`

### Platform capabilities

- [Migration guidance](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-migration/SKILL.md): `skills/dt-migration/SKILL.md`
- [JavaScript runtime](https://github.com/mf-dynatrace/dt-mcp-workspace/blob/main/skills/dt-js-runtime/SKILL.md): `skills/dt-js-runtime/SKILL.md`
- [Mobile setup](https://github.com/mf-dynatrace/dt-mcp-workspace/tree/main/skills/dt-setup-ios): `skills/dt-setup-ios`

### Other components

- **Engineer**
- **AI client**
- **Dynatrace documents**
- **Davis analyzers**

## Connections

- Engineer → AI client: asks questions (evidence: `README.md`)
- Dashboard extractor → Dynatrace documents: downloads content (evidence: `skills/dt-obs-analytics/scripts/extract-timeseries-dashboard.js`)
- Notebook extractor → Dynatrace documents: downloads content (evidence: `skills/dt-obs-analytics/scripts/extract-timeseries-notebook.js`)
- Davis analyzer runner → Davis analyzers: executes and polls (evidence: `skills/dt-obs-analytics/scripts/run-analyzer.js`)
- Dashboard extractor → Davis analyzer runner: provides query set
- Notebook extractor → Davis analyzer runner: provides query set
