Beispiel-Anwendungsfälle
 |
Das Model Context Protocol (Beta) wird derzeit im Vorschaumodus angeboten und stellt nur eine grundlegende Funktionsvalidierung bereit. Die vollständige Qualifizierung und erweiterte Funktionen werden in zukünftigen Versionen eingeführt.
|
Voraussetzungen
1. Erstellen Sie einen Anwendungsschlüssel in ThingWorx Composer. Legen Sie ein entsprechendes Ablaufdatum fest.
2. Richten Sie den MCP-Client mit VS Code IDE und Claude Desktop ein.
ThingWorx MCP-Server in VS Code IDE einrichten
1. Öffnen Sie VS Code IDE.
2. Drücken Sie STRG+UMSCHALT+P, um die Befehlspalette zu öffnen.
3. Wählen Sie den Befehl MCP Add Server aus.
4. Wählen Sie HTTP (HTTP or Server-Sent Events) aus.
5. Geben Sie ThingWorx Server URL>/mcp ein, und drücken Sie die EINGABETASTE.
6. Geben Sie den Servernamen ein, z.B. ThingWorxMCPServer, und drücken Sie die EINGABETASTE.
7. Wählen Sie je nach Geschäftsanforderungen Global oder Workspace aus, und drücken Sie die EINGABETASTE.
Die Datei mcp.json wird in VS Code IDE mit url und type als Schlüssel erstellt.
8. Fügen Sie den folgenden Code nach “type” hinzu: "headers": {<APPLICATION_KEY>"}
Ihre mcp.json-Datei sollte wie folgt aussehen:
{
"servers": {
"ThingworxMCP": {
"url": "https://centr154-eastus-iot-01-twx.ptcdevops.com/Thingworx/mcp",
"type": "http",
"headers": {
"AppKey": "a57da3b7-a7f7-4b05-b48a-ac6ccdc21939"
}
}
},
"inputs": []
9. Dadurch wird der MCP-Client in VS Code IDE gestartet.
Verwenden Sie das folgende URL-Format, wenn ThingWorx für Single Sign-On (SSO) konfiguriert ist: <ThingWorx Server URL>rp>mcp.
Beispielszenario
Ein Fertigungsbetrieb verfügt über mehrere zu überwachende Maschinen mit den folgenden kritischen KPIs:
• Status
• Temperatur
• Luftfeuchtigkeit
• Energieverbrauch
• Tägliche Laufzeit
• Tägliche Ausfallzeit
Erstellen Sie die folgenden Entitäten:
• Plant1.Machine.TT (Dingvorlage)
Eigenschaften:
◦ Status (STRING | Persistent | Protokolliert)
◦ Temperature (ZAHL | Persistent | Protokolliert)
◦ Humidity (ZAHL | Persistent | Protokolliert)
◦ EnergyConsumption (ZAHL | Persistent | Protokolliert)
• Plant1.WeldingMachine1.Thing Ding
• Plant1.WeldingMachine2.Thing Ding
• Plant1.WeldingMachine3.Thing Ding
• Plant1.WeldingMachine4.Thing Ding
• Plant1.WeldingMachine.VS (Wert-Stream)
Stellen Sie sicher, dass alle Dinge in regelmäßigen Abständen Live-Daten streamen.
Anwendungsfall 1
Zweck
Ein Betriebsmanager oder Maschinenbetreuer benötigt einen sofortigen Betriebsschnappschuss einer Maschine in der Fabrikhalle. Ziel ist es, die aktuelle Leistung schnell zu verstehen und anormale Bedingungen bei wichtigen Betriebsmetriken zu identifizieren.
Benutzer-Eingabeaufforderung
Den neuesten Maschinenstatus mit kritischen KPIs abrufen.
Ergebnis
Eine Zusammenfassung des Maschinenstatus mit den neuesten KPI-Werten wie Energieverbrauch, Temperatur und Gesamtlaufzeit.
Schritte
1. Erstellen Sie ein HelperThing namens MCP.HelperThing in ThingWorx.
2. Erstellen Sie einen GetCurrentMachineStatusKPI-Dienst mit:
◦ Input: machineName (STRING)
◦ Output: result (STRING)
3. Öffnen Sie die Ressource MCPServices, und wechseln Sie zur Registerkarte Services.
4. Suchen Sie den Dienst AddTools, und klicken Sie auf Execute.
5. Klicken Sie in der Eingabe toolInfo auf +Add.
6. Geben Sie Folgendes ein:
◦ Service Provider Name: MCP.HelperThing
◦ Service Provider Type: Thing
◦ Service Name: GetCurrentMachineStatusKPI
◦ Description: Dienst gibt den neuesten Status mit KPIs zurück. Er verwendet machineName als Eingabe und gibt KPI-Daten zurück.
◦ Application Name: ThingWorx
7. Klicken Sie auf Set.
8. Klicken Sie auf Save.
9. Klicken Sie auf Execute:
◦ Das Tool wurde erfolgreich hinzugefügt.
◦ Führen Sie GetAllTools aus, um zu bestätigen, dass das Tool hinzugefügt wurde.
10. Stellen Sie in VS Code IDE sicher, dass der MCP-Client ausgeführt wird. Die Anzahl der Tools und Eingabeaufforderungen sollten auf dem Bildschirm angezeigt werden.
11. Öffnen Sie das Chat-Fenster auf der rechten Seite.
12. Geben Sie die folgende Eingabeaufforderung ein: Den neuesten Maschinenstatus mit kritischen KPIs abrufen.
In der Ausgabe sollten die angeforderten KPI-Daten angezeigt werden.
Anwendungsfall 2
Zweck
Ein Betriebsmanager oder Maschinenbetreuer benötigt einen sofortigen Betriebsschnappschuss einer Maschine, weiß aber möglicherweise nicht, wie er eine effektive Eingabeaufforderung formulieren soll. Dieser Anwendungsfall hilft Benutzern, schnell auf Maschineninformationen zuzugreifen, ohne dass Kenntnisse der Eingabeaufforderungserstellung erforderlich sind.
Ergebnis
Das System bietet gebrauchsfertige Beispiel-Eingabeaufforderungen, die Benutzer je nach Bedarf nutzen, anpassen und verfeinern können. Dies ermöglicht den schnellen und konsistenten Zugriff auf kritische Maschineninformationen.
Schritte
1. Öffnen Sie die Ressource MCPServices, und wechseln Sie zur Registerkarte Services.
2. Suchen Sie den Dienst AddPrompts, und klicken Sie auf Execute.
3. Klicken Sie in der Eingabe promptInfo auf +Add.
4. Geben Sie die folgenden Details ein:
◦ Name: Aktuellen Status der Maschine abrufen
◦ Description: Eine Eingabeaufforderung, um den aktuellen Status einer Maschine abzurufen. Sie verwendet machineName als Eingabe.
◦ Content:
{
"text": "Get current status of {machineName}",
"type": "text"
◦ Prompt Arguments: Fügen Sie das Argument machineName hinzu.
5. Klicken Sie auf Add.
6. Klicken Sie auf Save.
7. Klicken Sie auf Execute.
◦ Die Eingabeaufforderung wurde erfolgreich hinzugefügt.
◦ Führen Sie GetAllPrompts aus, um zu bestätigen, dass die Eingabeaufforderung hinzugefügt wurde.
8. Stellen Sie in VS Code IDE sicher, dass der MCP-Client ausgeführt wird. Die Anzahl der Tools und Eingabeaufforderungen sollten auf dem Bildschirm angezeigt werden.
9. Öffnen Sie das Chat-Fenster auf der rechten Seite.
10. Geben Sie / in das Chat-Fenster ein, und wählen Sie die in den vorherigen Schritten hinzugefügte Eingabeaufforderung aus.
11. Geben Sie die Eingabewerte ein, und drücken Sie die EINGABETASTE. In der Ausgabe sollte der angeforderte Maschinenstatus angezeigt werden.
Anwendungsfall 3
Zweck
Ein Betriebsmanager oder Maschinenbediener hat Zugriff auf relevante Geschäfts- und Betriebsdaten, weiß aber nicht, wie er den Datensatz abfragen, die erforderlichen Informationen extrahieren oder aussagekräftige Erkenntnisse ableiten soll.
Ergebnis
Die verfügbaren Daten werden erfasst und als Ressource für das LLM als kontextbezogene Referenz bereitgestellt. Das LLM analysiert und interpretiert diese Daten und generiert eine Ausgabe, die auf die Eingabeaufforderung des Benutzers abgestimmt ist und klare, umsetzbare Erkenntnisse liefert, ohne dass der Benutzer die zugrunde liegende Datenstruktur oder Abfragesprache verstehen muss.
Schritte
1. Öffnen Sie die Ressource MCPServices, und wechseln Sie zur Registerkarte Services.
2. Suchen Sie den Dienst AddResources, und klicken Sie auf Execute.
3. Klicken Sie in der Eingabe resourceInfo auf +Add.
4. Geben Sie die folgenden Details ein:
◦ Name: QueryMachineData
◦ URI: file:///C:/Thingworx/ThingworxRepository/DataRepository/all-available-machine-data.json
 | Die im URI-Pfad referenzierte JSON-Datei enthält Maschinendaten, die aus dem Wert-Stream exportiert wurden. |
◦ Description: Eine Ressource zum Abrufen von Maschinendaten. Sie verwendet den Maschinennamen als Eingabe und gibt eine Infotable zurück.
◦ Service Provider Name: MCP.HelperThing
◦ Service Provider Type: Thing
5. Klicken Sie auf Add.
6. Klicken Sie auf Save.
7. Klicken Sie auf Execute.
◦ Die Ressource wurde erfolgreich hinzugefügt.
◦ Führen Sie GetAllResources aus, um zu bestätigen, dass die Eingabeaufforderung hinzugefügt wurde.
8. Stellen Sie in VS Code IDE sicher, dass der MCP-Client ausgeführt wird. Die Anzahl der Tools und Eingabeaufforderungen sollten auf dem Bildschirm angezeigt werden.
9. Drücken Sie STRG+UMSCHALT+P, um die Befehlspalette zu öffnen.
10. Wählen Sie den Befehl MCP: Browse Resources aus.
11. Wählen Sie QueryMachineData aus der Liste aus. all-available-machine-data.json wird als Ressource für das LLM im Chat-Fenster hinzugefügt.
12. Geben Sie eine Eingabeaufforderung für die angehängten Daten ein.