# marianfoo/sap-ai-mcp-servers architecture

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

- Interactive diagram: https://gitdiagram.com/marianfoo/sap-ai-mcp-servers
- Repository: https://github.com/marianfoo/sap-ai-mcp-servers

## Overview

This repository curates SAP MCP servers, AI skills, plugins, and adjacent tools as a catalog, with an interactive web catalog and generated README as its main results. Maintainers can add catalog entries; a metadata-enrichment process supplements repository details, and rendering turns catalog data into README tables. The README describes the web UI’s search, filters, sorting, and activity signals. The UI’s implementation and wiring were not sampled, so its internal data-flow links are left unverified.

Main entry points: [`scripts/enrich-data.mjs`](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/enrich-data.mjs) (Metadata enrichment), [`scripts/render-readme.mjs`](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/render-readme.mjs) (README rendering), [`index.html`](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/index.html) (Catalog page), [`data/catalog.json`](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/data/catalog.json) (Catalog entries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog Data"]
  node_catalog_data[("Catalog entries<br/>[catalog.json]")]
  node_metadata_overrides["Metadata overrides<br/>[overrides.json]"]
end

subgraph group_web["Catalog Experience"]
  node_web_page["Catalog page<br/>[index.html]"]
  node_catalog_ui["Search and filters<br/>[site.js]"]
  node_site_styles["Responsive styling<br/>[site.css]"]
end

subgraph group_generation["Metadata and Output"]
  node_enrichment["Metadata enrichment<br/>[enrich-data.mjs]"]
  node_enriched_catalog[("Enriched metadata")]
  node_readme_template["README template<br/>[README.template.md]"]
  node_readme_renderer["README rendering<br/>[render-readme.mjs]"]
  node_readme_output["Generated catalog README<br/>[README.md]"]
end

node_maintainer(("Catalog contributor"))
node_browser_user(("Catalog browser"))
node_github["GitHub metadata"]

node_maintainer -.->|"adds entries"| node_catalog_data
node_browser_user -->|"browses catalog"| node_web_page
node_web_page -.->|"uses UI"| node_catalog_ui
node_web_page -.->|"uses styles"| node_site_styles
node_enrichment -->|"reads entries"| node_catalog_data
node_enrichment -->|"reads overrides"| node_metadata_overrides
node_enrichment -->|"fetches metadata"| node_github
node_enrichment -->|"writes metadata"| node_enriched_catalog
node_readme_renderer -->|"reads entries"| node_catalog_data
node_readme_renderer -->|"reads metadata"| node_enriched_catalog
node_readme_renderer -->|"reads template"| node_readme_template
node_readme_renderer -->|"writes README"| node_readme_output

click node_catalog_data "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/data/catalog.json"
click node_metadata_overrides "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/data/overrides.json"
click node_web_page "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/index.html"
click node_catalog_ui "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/assets/site.js"
click node_site_styles "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/assets/site.css"
click node_enrichment "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/enrich-data.mjs"
click node_enriched_catalog "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/generated/catalog.enriched.json"
click node_readme_template "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/templates/README.template.md"
click node_readme_renderer "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/render-readme.mjs"
click node_readme_output "https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/README.md"

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_catalog_data,node_metadata_overrides,node_browser_user toneBlue
class node_web_page,node_catalog_ui,node_site_styles toneAmber
class node_enrichment,node_enriched_catalog,node_readme_template,node_readme_renderer,node_readme_output toneMint
class node_maintainer,node_github toneIndigo
```

## Components

### Catalog Data

- [Catalog entries](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/data/catalog.json): `data/catalog.json`
- [Metadata overrides](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/data/overrides.json): `data/overrides.json`

### Catalog Experience

- [Catalog page](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/index.html): `index.html`
- [Search and filters](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/assets/site.js): `assets/site.js`
- [Responsive styling](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/assets/site.css): `assets/site.css`

### Metadata and Output

- [Metadata enrichment](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/enrich-data.mjs): `scripts/enrich-data.mjs`
- [Enriched metadata](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/generated/catalog.enriched.json): `generated/catalog.enriched.json`
- [README template](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/templates/README.template.md): `templates/README.template.md`
- [README rendering](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/scripts/render-readme.mjs): `scripts/render-readme.mjs`
- [Generated catalog README](https://github.com/marianfoo/sap-ai-mcp-servers/blob/main/README.md): `README.md`

### Other components

- **Catalog contributor**
- **Catalog browser**
- **GitHub metadata**

## Connections

- Catalog contributor → Catalog entries: adds entries
- Catalog browser → Catalog page: browses catalog (evidence: `README.md`)
- Catalog page → Search and filters: uses UI
- Catalog page → Responsive styling: uses styles
- Metadata enrichment → Catalog entries: reads entries (evidence: `scripts/enrich-data.mjs`)
- Metadata enrichment → Metadata overrides: reads overrides (evidence: `scripts/enrich-data.mjs`)
- Metadata enrichment → GitHub metadata: fetches metadata (evidence: `scripts/enrich-data.mjs`)
- Metadata enrichment → Enriched metadata: writes metadata (evidence: `scripts/enrich-data.mjs`)
- README rendering → Catalog entries: reads entries (evidence: `scripts/render-readme.mjs`)
- README rendering → Enriched metadata: reads metadata (evidence: `scripts/render-readme.mjs`)
- README rendering → README template: reads template (evidence: `scripts/render-readme.mjs`)
- README rendering → Generated catalog README: writes README (evidence: `scripts/render-readme.mjs`)
