MCP 服务器

PP/DS MCP Server

Enables AI-assisted planning inquiries by exposing PP/DS OData APIs as MCP tools for SAP S/4HANA, allowing natural language queries about planned orders, production orders, and work centers.

README

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.

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:

Fiori App sendet Frage + Kontextdaten (z.B. Planauftragsnummer, Werk) an AI Core
AI Core Orchestration versteht die Anfrage, wählt passende MCP-Tools
MCP-Server ruft die PP/DS OData APIs im S/4HANA PCE ab
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`

Property	Wert
Name	`S4H_PCE`
Type	`HTTP`
URL	Virtual Host (Cloud Connector)
Authentication	`BasicAuthentication` oder `OAuth2SAMLBearerAssertion`
Proxy Type	`OnPremise`

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:

API	EntitySets	Use Case
`API_PLANNED_ORDERS`	PlannedOrder, PlannedOrderComponent, PlannedOrderCapacity	Planaufträge lesen, Komponenten, Kapazitätsbedarfe
`API_PRODUCTION_ORDERS_2_SRV`	ProductionOrder, ProductionOrderOperation	Fertigungsaufträge + Vorgänge
`API_WORK_CENTER_SRV`	WorkCenter	Arbeitsplätze / Ressourcen

→ 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)

Frage	API / EntitySet
Welche Planaufträge laufen diese Woche für Werk X?	`PlannedOrder`
Details zu Planauftrag XXXXXXX?	`PlannedOrder` GET
Welche Komponenten braucht Planauftrag X?	`PlannedOrderComponent`
Kapazitätsbedarf für Planauftrag X?	`PlannedOrderCapacity`
Status Fertigungsauftrag X?	`ProductionOrder` GET
Welche Vorgänge hat Fertigungsauftrag X?	`ProductionOrderOperation`
Alle offenen Aufträge für Material Y?	`ProductionOrder` ($filter)
Welche Arbeitsplätze gibt es in Werk Z?	`WorkCenter`