¶ 自定义MCP应用-进阶教程
¶ 前言
本文将以智能控制为场景，演示如何根据实际需求构建并应用自定义 MCP 服务，涵盖从应用创建到功能调试的全流程，帮助开发者高效实现灯光、窗帘等智能设备的精准控制。
提示：实操之前，请务必已经按照文档《基础教程-如何接入设备》，完成配置应用创建并接入，本文演示的MCP应用需要挂载于配置应用上。
¶ 实现效果
¶ 实现流程：
¶ 一. 创建自定义MCP服务应用
- 创建应用，应用类型选自定义，接入类型选云端服务
¶ 二. 在线编排：实现MCP功能流程
¶ 1. 进入在线编排界面
¶ 2. MCP Tools 节点配置：定义智能控制工具
MCP Tools 节点是实现设备控制的核心入口，需先配置工具基本信息，再关联后续执行流程
-
1).添加并初始化
MCP Tools节点- 从左侧节点列表中，找到
MCP Tools节点并拖拽至编排画布，双击节点进入配置界面。 
- 从左侧节点列表中，找到
-
2). 根据智能控制需求（以灯光控制为例），填写以下参数：
Name（名称）：用于标识这个工具，方便模型在众多工具中快速识别和区分。Description（描述）：对工具的功能进行说明，让模型清楚该工具能做什么。Input Schema（输入模式）：定义工具接收输入的格式和结构，JSON 格式-
type：指定输入数据的整体类型 -
properties：定义对象所包含的属性（即键值对里的 “键” 及对应值的规则） -
"type"：规定属性的值类型 -
"description": 对属性的含义做说明 -
required：对后面的请求中包含的属性 Route（路由）：指定了工具的访问路径，从何确定tool对应的流程
如果工具的落域效果不满意，可以试试调整Name和Description的描述，让模型更好识别你的工具使用场景。
¶ 3. 工具功能实现
-
1). 使用
http in节点：接收外部请求- 配置节点: 请求方式选择
POST,URL地址与前面工具的Route对应 
- 配置节点: 请求方式选择
-
2). 使用
mqtt out节点：实现智能设备控制- 根据需求配置服务器、主题、QoS等等
-
3). 将
http in节点和mqtt out节点链接
提示：若
MCP tool输出格式与要求不符，可在http in与mqtt out之间添加function函数节点来实现需要格式。
-
4). 使用
complete节点：实现完成回复- 绑定刚刚的
mqtt out节点 
- 绑定刚刚的
-
5). 使用与
function节点：构造响应json -
6). 使用
http response节点：返回结果
¶ 三. 拓展与调试
本章节旨在演示如何增加更多的MCP能力（控制 LED 以外设备，比如窗帘）。
如果您只想实现视频演示的效果（只控制 LED），本章节可以跳过。
¶ 1. 拓展
在MCP Tools中新建tool然后同样执行对应操作即可，这里添加/curtain为例
¶ 2. 调试
可以使用inject和debug节点进行调试
如果tool输出数据需要处理，将数据处理函数链接于http in节点之后
¶ 四. 功能验证
¶ 1. 点击右上角部署应用
¶ 2. 接入自定义MCP服务
- 获取MCP服务的url
- 自建配置应用挂载 MCP 服务器 （请务必已经按照文档《基础教程-如何接入设备》，完成配置应用创建并接入）
¶ 3. 触发语料
“打开灯光”、“关闭灯光”、“把灯打开”、“把灯关了”等对灯的开关指令
¶ 附：本示例的模板 和 MQTT客户端
- 云端编排模板：自定义MCP应用示例.json
- MQTT客户端：mqtt-led-controller.zip （请用户自行安装 Python 环境）
- 解压后，通过 powershell 打开该文件夹
- 执行命令
pip install -r .\requirements.txt安装所有依赖包 - 执行命令
python.exe .\mqtt_led_controller.py - 浏览器访问地址
localhost:5000即可打开测试网页
