调整提示词

data_collector_mcp/s7_server.py

@@ -39,9 +39,7 @@ class S7PointCreateItem(TypedDict):
     name: str
     address: str
     data_type: NotRequired[str]
-    type: NotRequired[str]
     register_type: NotRequired[int]
-    register_area: NotRequired[str]
     point_id: NotRequired[str]
     scale_ratio: NotRequired[float]
     value_offset: NotRequired[float]
@@ -55,16 +53,11 @@ class S7PointCreateItem(TypedDict):
 @mcp.tool(
     name="s7.raw_read",
     description=(
-        "通过采集网关对 Siemens S7 TCP 设备执行原始字节读取。调用 "
-        "{base_url}/api/dc-gateway/s7/read。请求字段使用网关/汇采一致命名："
-        "ip 为 PLC 地址，port 默认 102，rock 为机架号，slot 为槽号，"
-        "device_type 为设备类型，默认 S7-1200，可传 S7-1200、S7-Smart200。"
-        "tsap_conn_type 可选 PG、OP、BASIC；未传时统一使用 PG；只有明确需要 OP/BASIC 时才显式传。"
+        "采集网关-对 Siemens S7 TCP 设备执行原始字节读取。"
+        "device_type 为设备类型，可传S7-1200、 S7-1200、S7-Smart200。"
+        "tsap_conn_type 可选 PG、OP、BASIC"
         "read 必须包含 area、start、size；"
-        "area 可用 DB、M、I、Q，S7-Smart200 还支持 V；area=DB 时 read.db 必须大于 0。"
-        "该接口不解析业务值，只返回语义化 communication：S7_CONNECT、S7_CONNECTED、"
-        "S7_READ、原始十六进制字节、S7_DISCONNECT 或 S7_ERROR。"
-        "响应透传上游 JSON，code=0 表示业务成功，code!=0 时 msg 为失败原因。"
+        "area 可用 DB、M、I、Q、V"
     ),
 )
 def s7_raw_read(
@@ -92,18 +85,14 @@ def s7_raw_read(
 @mcp.tool(
     name="s7.point_collect_test",
     description=(
-        "通过采集网关读取 Siemens S7 TCP 点位并转换为业务值。调用 "
-        "{base_url}/api/dc-gateway/s7/read_points。请求字段使用网关/汇采一致命名："
+        "采集网关-读取 Siemens S7 TCP 点位数据"
         "ip 为 PLC 地址，port 默认 102，rock 为机架号，slot 为槽号，"
-        "device_type 为设备类型，默认 S7-1200，可传 S7-1200、S7-Smart200。"
-        "tsap_conn_type 可选 PG、OP、BASIC；未传时统一使用 PG；只有明确需要 OP/BASIC 时才显式传。"
+        "device_type 为设备类型，可传S7-1200、 S7-1200、S7-Smart200。"
+        "tsap_conn_type 可传 PG、OP、BASIC；"
         "points 为网关读取格式的点位数组，每个点位必须包含 "
-        "area、start、type；area 可用 DB、M、I、Q，S7-Smart200 还支持 V；"
-        "area=DB 时 db 必须大于 0。"
+        "area、start、type；area 可用 DB、M、I、Q、V；"
         "type 可用 bool、byte、int8、int16、uint16、int32、uint32、int64、uint64、"
         "float32、float64；bool 点可传 bit 读取指定 0..7 位，非 bool 点不能传 bit。"
-        "S7 多字节数值按大端解析，响应 data.points[].value 为转换后的业务值，"
-        "data.communication 为语义化连接/读取/断开记录。响应透传上游 JSON，code=0 表示业务成功。"
     ),
 )
 def s7_point_collect_test(
@@ -131,11 +120,7 @@ def s7_point_collect_test(
 @mcp.tool(
     name="s7.connect_scan",
     description=(
-        "通过采集网关扫描 Siemens S7 TCP 设备可用连接组合。调用 "
-        "{base_url}/api/dc-gateway/s7/connect_scan。只需要传 PLC 的 ip，网关固定使用端口 102，"
-        "扫描 rock=0/1/2、slot=0/1/2、tsap_conn_type=PG/OP/BASIC 共 27 种组合。"
-        "响应 data.available 只返回可连接成功的组合，每项包含 rock、slot、tsap_conn_type；"
-        "如果没有可用组合则 available 为空数组。响应透传上游 JSON，code=0 表示扫描完成。"
+        "采集网关-扫描 Siemens S7 TCP 设备可用连接组合。只需要传 PLC 的 ip"
     ),
 )
 def s7_connect_scan(project_key: str, ip: str) -> dict[str, Any]:
@@ -152,18 +137,13 @@ def _resolve_collector_s7_tsap_conn_type(device_type: int, tsap_conn_type: str |
 @mcp.tool(
     name="collector.s7_device_create",
     description=(
-        "汇采-批量创建 S7 设备。依次调用 {data_collector_base_url}/api/collector/device，"
+        "汇采-批量创建 S7 设备。"
         "type=s7。接收project_key和devices列表,"
         "devices 每项必须传 name 名称、ip IP 地址、rock 机架号(轨道号)、slot 槽号；"
-        "port 默认 102，device_type 默认 1。device_type 必须使用数字枚举，不要传网关读取工具里的字符串："
+        "port 默认 102，device_type 默认 1。device_type 必须使用数字枚举，"
         "1=S7-1200, 2=S7-1500, 3=S7-Smart200。tsap_conn_type 可选 PG、OP、BASIC；"
-        "未传时统一使用 PG；只有现场测试或扫描确认需要 OP/BASIC 时才显式传。"
-        "默认参数: is_persistent=false, "
         "device_group_id=0, timeout=3, alarm_interval=90, collect_interval=5。"
-        "从设备 CSV/网关结果转换时：S7-Smart200=>device_type=3；创建入参示例 "
-        "{name:'plc1',ip:'192.168.1.10',port:102,rock:0,slot:1,device_type:3,tsap_conn_type:'PG'}。"
-        "全部设备创建调用完成后会内部调用设备列表并匹配每个设备 id,"
-        "返回批量结果，state=0 表示全部创建并匹配成功。"
+        "全部设备创建调用完成后会内部调用设备列表并匹配每个设备 id。"
     ),
 )
 def collector_s7_device_create(
@@ -176,14 +156,11 @@ def collector_s7_device_create(
 @mcp.tool(
     name="collector.s7_device_edit",
     description=(
-        "汇采-编辑 S7 设备。调用 {data_collector_base_url}/api/collector/s7/device/update。"
+        "汇采-编辑 S7 设备。"
         "必须传 ori_id 原设备 id、name、ip、rock、slot；port 默认 102，device_type 默认 1，"
         "tsap_conn_type 可选 PG、OP、BASIC；未传时统一使用 PG；只有明确需要 OP/BASIC 时才显式传。"
         "编辑前设备不能处于已连接状态；若已连接，请先调用 "
-        "collector.device_disconnect，并传 device_type=s7。该接口是全量更新语义。"
-        "默认参数: is_persistent=false, device_group_id=0, timeout=3, alarm_interval=90, "
-        "collect_interval=5。device_type: 1=S7-1200, 2=S7-1500, 3=S7-Smart200。"
-        "tsap_conn_type 可用 PG、OP、BASIC。响应透传上游 JSON，state=0 表示业务成功。"
+        "collector.device_disconnect，并传 device_type=s7。"
     ),
 )
 def collector_s7_device_edit(
@@ -225,22 +202,16 @@ def collector_s7_device_edit(
 @mcp.tool(
     name="collector.s7_point_create",
     description=(
-        "汇采-批量创建 S7 采集点位。依次调用 {data_collector_base_url}/api/collector/s7/point/add。"
-        "points 每项必须传 device_id、name、address、data_type 或 type，"
-        "以及 register_type 或 register_area。每个点位会补齐默认值: point_id='', "
-        "scale_ratio=1, value_offset=0, group_Id=0, invalid_values='', valid_range_start=null, "
-        "valid_range_end=null。register_type: 1=I输入区, 2=Q输出区, 3=M存储区, 4=DB数据块, "
-        "5=V区, 6=AI模拟输入；register_area 可用 I、Q、M、DB、V、AI。"
+        "汇采-批量创建 S7 采集点位。"
+        "points 每项必须传 device_id、name、address、data_type、"
+        "register_type 寄存器类型: 1=I输入区, 2=Q输出区, 3=M存储区, 4=DB数据块, 5=V区， 6=AI模拟输入"
         "data_type 可用 bool, uint8, int8, uint16, int16, uint32, int32, float32, float64。"
         "常见点表类型映射: BOOL=>bool, FLOAT/REAL=>float32, SHORT/INT=>int16, WORD=>uint16, "
         "DWORD=>uint32, DINT/LONG=>int32, DOUBLE/LREAL=>float64。"
-        "S7 地址格式：I/Q/M/V 布尔点通常为 byte.bit，如 10.2；DB 布尔点为 db.byte.bit，"
+        "address 地址格式：I/Q/M/V 布尔点通常为 byte.bit，如 10.2；DB 布尔点为 db.byte.bit，"
         "如 1.10.2；非布尔点 I/Q/M/V 通常为 byte 地址，如 10，DB 为 db.byte，如 1.10。"
-        "注意本工具是汇采创建格式，不是网关读取格式；不要传 area/start/bit。"
-        "从常见 CSV 区域转换时：I=>register_area I；Q/QD=>Q；M/MD=>M；VD/VW=>V；"
         "DB/DBD/DBW/DBX=>DB。BOOL 点把地址列和位地址列合并为 address='byte.bit'；"
         "DB BOOL 合并为 address='db.byte.bit'；非 BOOL 使用字节地址，DB 非 BOOL 使用 'db.byte'。"
-        "响应透传上游 JSON，state=0 表示业务成功。"
     ),
 )
 def collector_s7_point_create(
@@ -259,14 +230,12 @@ def _dump_model_or_dict(item: Any) -> dict[str, Any]:
 @mcp.tool(
     name="collector.s7_point_edit",
     description=(
-        "汇采-编辑 S7 采集点位。调用 {data_collector_base_url}/api/collector/s7/point/update。"
+        "汇采-编辑 S7 采集点位。"
         "必须传 ori_id 原点位 id、device_id 所属设备 id、name、address、data_type，"
-        "以及 register_type 或 register_area。ori_id 对应 collector.device_points 返回的 data.point[].id。"
-        "该接口是全量更新语义，未传字段可能被默认值覆盖。默认参数: point_id='', "
+        "以及 register_type 。"
         "scale_ratio=1, value_offset=0, group_Id=0, invalid_values='', valid_range_start=null, "
-        "valid_range_end=null。register_type: 1=I, 2=Q, 3=M, 4=DB, 5=V, 6=AI。"
+        "valid_range_end=null。register_type 寄存器类型: 1=I输入区, 2=Q输出区, 3=M存储区, 4=DB数据块, 5=V区， 6=AI模拟输入。"
         "data_type 可用 bool, uint8, int8, uint16, int16, uint32, int32, float32, float64。"
-        "响应透传上游 JSON，state=0 表示业务成功。"
     ),
 )
 def collector_s7_point_edit(