示例用例
 |
模型上下文协议 (测试版) 目前以预览模式提供，且仅提供基本功能验证。完整的资格认证和扩展功能将在未来版本中推出。
|
先决条件
1. 在 ThingWorx Composer 中创建 AppKey。设置相应的到期日期。
2. 使用 VS Code IDE 和 Claude Desktop 设置 MCP 客户端。
在 VS Code IDE 中设置 ThingWorx MCP 服务器
1. 打开 VS Code IDE。
2. 按 Ctrl+Shift+P 键，打开命令选项板。
3. 选择命令 MCP 添加服务器。
4. 选择 HTTP (HTTP 或服务器发送的事件)。
5. 输入 ThingWorx Server URL>/mcp，然后按 Enter 键。
6. 输入服务器名称 (例如 ThingWorxMCPServer)，然后按 Enter 键。
7. 根据业务需求选择“全局”或“工作区”，然后按 Enter 键。
文件 mcp.json 在 VS Code IDEO 中创建，其中以 url 和 type 为键。
8. 在 “type” 之后添加以下代码："headers": {<APPLICATION_KEY>"}
mcp.json 文件应如下所示：
{
"servers": {
"ThingworxMCP": {
"url": "https://centr154-eastus-iot-01-twx.ptcdevops.com/Thingworx/mcp",
"type": "http",
"headers": {
"AppKey": "a57da3b7-a7f7-4b05-b48a-ac6ccdc21939"
}
}
},
"inputs": []
9. 这会在 VS Code IDE 中启动 MCP 客户端。
如果已将 ThingWorx 配置为支持单点登录 (SSO)，请使用以下 URL 格式：<ThingWorx Server URL>rp>mcp。
示例场景
制造工厂通过多台机器监控以下关键 KPI：
• 状态
• Temperature
• 湿度
• 能源消耗
• 每天运行时间
• 每天停机时间
创建以下实体：
• Plant1.Machine.TT (ThingTemplate)
属性：
◦ Status (STRING | Persist | Logged)
◦ Temperature (NUMBER | Persist | Logged)
◦ Humidity (NUMBER | Persist | Logged)
◦ EnergyConsumption (NUMBER | Persist | Logged)
• Plant1.WeldingMachine1.Thing 事物
• Plant1.WeldingMachine2.Thing 事物
• Plant1.WeldingMachine3.Thing 事物
• Plant1.WeldingMachine4.Thing 事物
• Plant1.WeldingMachine.VS (值流)
确保所有事物定期传输实时数据。
用例 1
用途
工厂经理或机器主管需要获得工厂车间中的机器即时运行快照。目标是快速了解当前性能并识别关键运营指标中异常情况。
用户提示
获取最新机器状态以及关键 KPI。
结果
机器状态汇总以及最新 KPI 值，例如能耗、温度和总运行时间。
步骤
1. 在 ThingWorx 中创建一个名为 MCP.HelperThing 的 HelperThing。
2. 使用以下内容创建服务 GetCurrentMachineStatusKPI：
◦ “输入”：machineName (字符串)
◦ “输出”：result (字符串)
3. 打开 MCPServices 资源并转至“服务”选项卡。
4. 搜索 AddTools 服务，然后单击“执行”。
5. 在 toolInfo 输入中，单击“+ 添加”。
6. 输入：
◦ 服务提供者名称：MCP.HelperThing
◦ 服务提供者类型：Thing
◦ 服务名称：GetCurrentMachineStatusKPI
◦ 说明：服务返回最新状态以及 KPI。它将 machineName 作为输入并返回 KPI 数据。
◦ 应用程序名称：ThingWorx
7. 单击“设置”。
8. 单击“保存”。
9. 单击“执行”：
◦ 即可成功添加工具。
◦ 执行 GetAllTools 以确认工具是否成功添加。
10. 在 VS Code IDE 中，确保 MCP 客户端正在运行。屏幕上应显示工具和提示的数量。
11. 打开右侧的聊天窗口。
12. 输入提示：获取最新机器状态以及关键 KPI。
输出应显示请求的 KPI 数据。
用例 2
用途
工厂经理或机器主管需要机器的即时运行快照，但可能不知道如何编写有效提示。此用例可帮助用户快速访问机器信息，而无需提示工程专业知识。
结果
系统提供了即用型示例提示，用户可以根据需要使用、自定义和优化这些提示。这样可以快速、一致地访问重要的机器信息。
步骤
1. 打开 MCPServices 资源并转至“服务”选项卡。
2. 搜索 AddPrompts 服务，然后单击“执行”。
3. 在 promptInfo 输入中，单击“+ 添加”。
4. 输入以下详情：
◦ 名称：获取机器的当前状态
◦ 说明：用于获取计算机当前状态的提示。它采用 machineName 作为输入。
◦ 内容：
{
"text": "Get current status of {machineName}",
"type": "text"
◦ 提示自变量：添加自变量 machineName。
5. 单击“添加”。
6. 单击“保存”。
7. 单击“执行”。
◦ 即可成功添加提示。
◦ 执行 GetAllPrompts 以确认提示是否已成功添加。
8. 在 VS Code IDE 中，确保 MCP 客户端正在运行。屏幕上应显示工具和提示的数量。
9. 打开右侧的聊天窗口。
10. 在聊天窗口中输入 /，然后选择在上述步骤中添加的提示。
11. 键入输入值，然后按 Enter 键。输出应显示请求的机器状态。
用例 3
用途
工厂经理或机器操作员有权访问相关业务和运营数据，但不知道如何查询数据集、提取所需信息以及如何获得有意义的见解。
结果
将可用数据提取并公开为资源，供 LLM 用作上下文参考。LLM 解析和解释此数据，并生成与用户提示相符的输出，提供清晰、可操作的见解，而无需用户了解底层数据结构或查询语言。
步骤
1. 打开 MCPServices 资源并转至“服务”选项卡。
2. 搜索 AddResources 服务，然后单击“执行”。
3. 在 resourceInfo 输入中，单击“+ 添加”。
4. 输入以下详情：
◦ 名称：QueryMachineData
◦ URI：file:///C:/Thingworx/ThingworxRepository/DataRepository/all-available-machine-data.json
 | URI 路径中引用的 JSON 文件包含从值流导出的机器数据。 |
◦ 说明：用于获取机器数据的资源。它以机器名称作为输入并返回信息表。
◦ 服务提供者名称：MCP.HelperThing
◦ 服务提供者类型：事物
5. 单击“添加”。
6. 单击“保存”。
7. 单击“执行”。
◦ 资源已成功添加。
◦ 执行 GetAllResources 以确认提示是否已成功添加。
8. 在 VS Code IDE 中，确保 MCP 客户端正在运行。屏幕上应显示工具和提示的数量。
9. 按 Ctrl+Shift+P 键，打开命令选项板。
10. 选择命令 MCP：浏览资源。
11. 从列表中选择 QueryMachineData。在聊天窗口中将 all-available-machine-data.json 添加为 LLM 的资源。
12. 为附加数据输入提示。