PP/DS MCP Server – Projektdokumentation

Ziel

KI-gestützte Planungsauskunft direkt in SAP: Eine Custom Fiori App im S/4HANA PCE System schickt Planungsfragen an SAP AI Core, der über den MCP-Server auf PP/DS-Daten zugreift und die Antwort direkt zurück in die Fiori App liefert.

Related MCP server: SAP OData to MCP Server

Architektur (Zielzustand)

┌─────────────────────────────────┐
│       S/4HANA Private Cloud     │
│                                 │
│  ┌──────────────────────────┐   │
│  │  Custom Fiori App        │   │
│  │  (Input: Frage + Kontext)│   │
│  └────────────┬─────────────┘   │
│               │ OData/HTTP      │
│  ┌────────────▼─────────────┐   │
│  │  BTP Integration / ABAP  │   │
│  │  HTTP Outbound Call      │   │
│  └────────────┬─────────────┘   │
└───────────────┼─────────────────┘
                │ Cloud Connector / Private Link
                ▼
┌─────────────────────────────────┐
│          SAP BTP                │
│                                 │
│  ┌──────────────────────────┐   │
│  │  SAP AI Core             │   │
│  │  Orchestration Service   │   │
│  └────────────┬─────────────┘   │
│               │ MCP Tool Calls  │
│  ┌────────────▼─────────────┐   │
│  │  PP/DS MCP Server        │   │
│  │  (dieses Repo)           │   │
│  │  odata-mcp-proxy         │   │
│  └────────────┬─────────────┘   │
│               │ OData           │
└───────────────┼─────────────────┘
                │ Cloud Connector / Private Link
                ▼
┌─────────────────────────────────┐
│       S/4HANA Private Cloud     │
│                                 │
│  ┌──────────────────────────┐   │
│  │  PP/DS OData APIs        │   │
│  │  (Planned/Prod. Orders,  │   │
│  │   Work Centers, ...)     │   │
│  └──────────────────────────┘   │
└─────────────────────────────────┘
                │
                │ Antwort zurück durch denselben Pfad
                ▼
        Custom Fiori App Output

Datenpfad:

1. Fiori App sendet Frage + Kontextdaten (z.B. Planauftragsnummer, Werk) an AI Core

2. AI Core Orchestration versteht die Anfrage, wählt passende MCP-Tools

3. MCP-Server ruft die PP/DS OData APIs im S/4HANA PCE ab

4. Antwort läuft zurück: MCP → AI Core → Fiori App

Komponenten

1. Custom Fiori App (S/4HANA PCE)

• Eingebettet in SAP-Transaktion oder eigenständige App

• Sendet strukturierten Kontext an AI Core (z.B. aktuell geöffneter Planauftrag, Werk, Zeitraum)

• Zeigt die AI-Antwort direkt in der UI an

• Tech: SAP UI5 / Fiori Elements, ABAP OData oder CAP Backend

2. SAP AI Core (BTP)

• Orchestration Service als zentrales AI-Brain

• Nimmt die Anfrage der Fiori App entgegen

• Entscheidet welche MCP-Tools aufgerufen werden

• Gibt formatierte Antwort zurück

3. PP/DS MCP Server (dieses Repo, BTP CF)

• Powered by odata-mcp-proxy

• Exposes PP/DS OData APIs als MCP-Tools

• Kein eigener Code — nur api-config.json

• Läuft auf BTP Cloud Foundry, nutzt Destination Service + Cloud Connector

4. S/4HANA PCE OData APIs

• Planaufträge (API_PLANNED_ORDERS)

• Fertigungsaufträge (API_PRODUCTION_ORDERS_2_SRV)

• Arbeitsplätze (API_WORK_CENTER_SRV)

• Erweiterbar via Custom CDS Views

BTP Deployment (MCP Server)

Voraussetzungen

• SAP BTP Subaccount (Cloud Foundry aktiviert)

• Cloud Connector konfiguriert mit Virtual Host für S/4HANA PCE

• BTP Destination S4H_PCE angelegt (OnPremise, Basic oder OAuth2SAML)

• Services: Destination, Connectivity, XSUAA

BTP Destination S4H_PCE

Deployment

npm install -g mbt
mbt build
cf login -a https://api.cf.<region>.hana.ondemand.com
cf deploy mta_archives/ppds-mcp-server_1.0.0.mtar

API Konfiguration (api-config.json)

Drei API-Gruppen, read-only:

→ Details in api-config.json

Beispiel-Interaktionen

Fiori App schickt an AI Core (mit Kontext Werk=1000, Material=FG-001):

„Welche Planaufträge für Material FG-001 laufen diese Woche?" → AI Core → PlannedOrder_list mit $filter auf Material + Datum → Antwort in Fiori

„Auf welchem Arbeitsplatz wird Planauftrag 1234567 gefertigt?" → AI Core → PlannedOrderCapacity_get → WorkCenter aus Ergebnis → Antwort

„Welche Komponenten fehlen für Planauftrag 1234567?" → AI Core → PlannedOrderComponent_list → Abgleich mit Verfügbarkeit → Antwort

Covered Use Cases (Phase 1 – Read-only)

Roadmap

• MCP Server Konfiguration (api-config.json)

• BTP Deployment Setup (mta.yaml, xs-security.json)

• BTP Deployment ausführen + testen

• AI Core Orchestration: MCP-Tools registrieren

• Custom Fiori App: AI Core Integration (Input/Output)

• Phase 2: Write-Operationen (Planauftrag ändern)

• Custom CDS Views für Lücken (aggregierte Kapazitätsauslastung, Alerts)

Referenzen

• odata-mcp-proxy GitHub

• odata-mcp-proxy Blog

• AI Core MCP Server Blog

• SAP API Hub – Planned Orders

• SAP API Hub – Production Orders