PortDock MCP

PortDock

한국어

用于在 Windows 上测试现场硬件的免费通信工具。每款工具都是独立的小型下载包；它们共用同一套通信和解码核心。

工具	功能
PortDock Serial	串口（COM）终端 — RS-232/RS-485/USB 串口、信号线（DTR/RTS/CTS/DSR/RI/CD）、USB 重新插入后自动重连、帧格式、校验和（九种类型加自定义 CRC）、Modbus RTU 解码和请求生成器、自动回复、带时间戳的测试日志；从 0.10.0 起支持端口共享（COM ↔ TCP，原始模式或 RFC 2217，默认使用 127.0.0.1 上的 TCP 7000 端口）、Modbus TCP ↔ RTU 网关（通过 Modbus TCP 将 SCADA/HMI 连接到 RS-485 设备，默认使用 127.0.0.1 上的 TCP 502 端口，一次处理一个请求，超时 → 异常 0B，除非选择 RTU 广播，否则单元 ID 0 会以异常 0A 回复；使用允许的单元列表时，需将列表 0 加入其中）以及 Modbus RTU 只监听抓包（CRC 帧解析、请求/回复配对、回复时间）
PortDock Modbus Slave	通过串口 RTU、Modbus TCP 或 TCP 上的 RTU 模拟 Modbus 从站 — 线圈和寄存器表（32 位、浮点数和字符串单元格）、数值模拟（从 0.10.0 起也支持噪声 — 在限制范围内缓慢随机漂移）、故障注入、内置设备配置文件（从 0.10.0 起支持「模拟设备…」，提供实时数值 — 运行命令 → 输出频率渐变、能量累积 — 强制只读/只写，并对映射表中不存在的地址返回异常 02）、CSV 寄存器映射表，以及接收主站请求时的显示。Modbus TCP 监听你选择的地址（从 0.10.0 起，首次运行时使用 127.0.0.1 — 若主站在另一台 PC 上，请选择 0.0.0.0 或某个网络适配器的地址）
PortDock TCP	TCP 客户端、服务端和中继（监视器）— 多个对等端、回显、自动重连、Modbus TCP 帧解析、中继捕获保存为 pcapng（可在 Wireshark 中打开）、Modbus TCP 和 MC 请求/回复配对及响应时间和无回复计数
PortDock UDP	UDP 发送器/接收器 — 广播、多播、回显
PortDock Simulator	通过串口、TCP 和 UDP 模拟基于规则的设备 —「收到这个时，回复那个」
PortDock Net Scan	查找工业网络上的设备：ping/ARP 扫描、MAC 厂商、工业端口（Modbus 502、MC、XGT …）、长期 ping 监视器、Wake-on-LAN；从 0.10.0 起支持命名基准 — 将扫描结果与已保存的设备列表对比（新增、缺失、MAC 变更、IP 变更、开放端口变更；CSV）；从 0.10.0 起，当开放端口中包含无身份验证的工业协议（Modbus、MC、EtherNet/IP、S7、OPC UA）或 Telnet/HTTP 时显示暴露风险提示 — 不会额外扫描；从 0.11.0 起支持按需广播发现 — 向所选网络适配器的广播地址发送 EtherNet/IP ListIdentity（UDP 44818）和 BACnet Who-Is（UDP 47808）：显示厂商、设备类型、产品名称和版本 / 设备实例、厂商 ID 和最大 APDU（不显示序列号）
PortDock Modbus Master	Modbus RTU/TCP 主站（轮询工具）：多个轮询表、类型化数值（U16–F64、字符串、字节序、40001 表示法）、写入 05/06/0F/10、从站 ID 和地址范围扫描、内置设备配置文件、解码后的通信流量、统计信息、CSV 数值日志、趋势图；从 0.10.0 起支持线路设置搜索（未知波特率/奇偶校验/ID — 每种组合只进行短暂读取，绝不使用 ID 0）、「无响应」可能原因面板（无字节、仅回显、CRC 错误、帧被截断、异常、其他 ID）、设备设置备份、对比和恢复（JSON/CSV，写入前后均可预览并检查回读），以及数值监视和警报（低/高限值带回差、数值停滞 N 秒、通信中断 N 秒；警报列表支持确认、可选声音和警报 CSV 日志 — 仅用于辅助监视，不是安全设备）
PortDock SCPI	通过 LAN 套接字（5025）或 RS-232 连接 SCPI 仪器的终端，无需 VISA：查询/写入/读取并显示响应时间、*IDN? 识别、清空错误队列、等待 *OPC?、重复数值测量（表格、趋势图、CSV）、块数据（#…）支持 HEX 预览和文件保存
PortDock Plot	实时绘制串口、TCP 或 UDP 数值的工具：逗号/空格/制表符/分号分隔文本（自动检测）、Arduino 风格的 name:value、表头名称、二进制帧（起始字节、u8–f64、字节序、校验和）；最多 32 个通道，可使用左/右轴，支持暂停、游标、两点 Δt/Δvalue、缩放；统计信息、接收时录制 CSV、导出 CSV/PNG；从 0.10.0 起支持按通道监视和警报（限值、停滞、数据丢失）
PortDock Port Inspector	只读 COM 端口检查工具，无需管理员权限：设备和驱动程序信息（供应商、版本、日期、INF）、设备管理器问题代码及其含义和建议的处理方法、通过 VID/PID 识别 USB 芯片（FTDI、Prolific、WCH、Silicon Labs …）、设备设置（如 FTDI 延迟计时器）、USB 电源管理、事件日志中的插拔和驱动程序历史、COM 号预留（孤立和重复号码）；按波特率进行 TX–RX 回环测试（丢失/变更的字节、往返毫秒数）和两线制 RS-485 回显检查；从 0.10.0 起支持双端口测试（两个适配器互连，双向测试）、测试模式（0x00–0xFF、0x55/0xAA）和文字接线图 — Serial 的「检查连接…」中也提供此功能；从 0.10.0 起支持「与上次对比」（保存检查结果，之后只查看发生变化的内容：COM 号、驱动程序版本/日期、USB 位置、适配器和 PC 设置、新出现的蓝屏 — 不存储序列号）。还提供本 PC 网络适配器选项卡（链路速度、双工模式、巨型帧和电源管理，另含 GigE 摄像机模式）、设备 PC 的 Windows 设置（快速启动、睡眠、更新重启、时间同步、意外关机；从 0.10.0 起还包括蓝屏和突然关机 — 停止代码、Kernel-Power 41、EventLog 6008、仅统计 Minidump 文件数量 —、NVMe 存储健康状况、唤醒 PC 的原因、电池容量和现场 PC 暴露检查 — 远程桌面/NLA、SMBv1、防火墙配置文件、监听所有地址的端口、自动登录、USB AutoPlay），以及无线功能（Wi-Fi 适配器电源管理和断连历史、蓝牙适配器、服务和免提音频）。支持导出文本/JSON。绝不会更改设置
PortDock PLC Simulator	MC 协议（SLMP）服务端模拟器，根据 Mitsubishi Electric 的公开手册实现（无关联关系；行为可能与真实 PLC 不同）— 3E/4E 帧、二进制/ASCII、TCP 服务端或 UDP、批量和随机读写及回环、18 种设备（D、W、R、ZR、M、X、Y、B、L、SM、SD …），其中 X/Y/B/W/ZR 使用十六进制编号，错误回复包含结束代码，支持故障注入、数值模拟、JSON 保存/加载。从 0.10.0 起，还可回复 LS ELECTRIC XGT 专用协议（FEnet，TCP 2004 / UDP 2005 — 对 %MW·%MX·%DB… 变量进行单项和连续读写，根据 LS ELECTRIC 的公开手册实现，无关联关系）。默认监听 127.0.0.1；「允许其他 PC 连接（0.0.0.0）」会使其对网络开放。
PortDock Hardware Tester	面向 Windows PC 的 Wi-Fi、蓝牙和 USB 记录器，只读且无需管理员权限：仅在记录期间同时 ping 网关和一个互联网地址（延迟、丢包、抖动），并记录 DNS 响应时间和 Windows 记录的 Wi-Fi 断连原因，在同一时间线上显示；提供指出排查方向的「路由器侧 / 路由器之外」摘要，并可导出 CSV；记录已配对蓝牙设备的连接和断开时间（仅在屏幕上显示名称）、蓝牙音频模式（立体声或免提）并播放左右声道测试音；按需显示 Wi-Fi 信号、链路速度、频段和信道，并统计附近网络在各信道的数量（Windows 11 24H2 及更高版本需要位置权限；绝不读取网络名称）；从 0.10.0 起支持 USB 连接/断开日志（设备通知加每 3 秒检查一次设备列表；显示名称、VID:PID、集线器端口和速度；10 分钟内断开 3 次时标记为「疑似反复断连」，检测以 USB 2.0 速度运行的 USB 3 设备，并从 Kernel-PnP 日志读取「较早记录」— 绝不显示、复制或保存设备序列号）。要测试键盘、鼠标、显示器、扬声器、麦克风、网络摄像头和游戏手柄，请使用网站上的 PC 硬件测试（在浏览器中使用，无需安装）。
PortDock MCP	面向 AI 客户端（Claude Desktop、VS Code、Cursor …）的 MCP 服务，无窗口，通过 stdio 通信：让 AI 读取 COM 端口和 Port Inspector 报告、监听串口（不发送任何内容）、读取 Modbus（FC 01–04）、MC 协议 3E（0401）和 SCPI 查询、执行 ping、读取网络适配器信息和内置设备寄存器映射表。两个写入工具仅接受 127.0.0.1（本 PC），用于通过模拟器练习；从 0.10.0 起，modbus_write_sim 也仅在目标厂商名称以「PortDock」开头时才写入（读取设备识别信息，FC 2B/0E — PortDock Modbus Slave 默认如此），因此会拒绝连接到真实设备的转发器，例如 PortDock Serial 的 Modbus TCP ↔ RTU 网关（默认使用 127.0.0.1:502）。mc_write_sim 仅按地址检查（Serial 网关只转发 Modbus），因此当本 PC 上的程序正在向另一台设备转发数据时（TCP 中继、网关、隧道），请勿使用。每次调用都会记录在本地会话日志中。详情：docs/mcp.md
所有 12 款应用：点击标题栏中的「AI」按钮，即可将当前情况（连接设置、错误、近期流量或检查结果）复制为文本到剪贴板，以便粘贴到 AI 聊天中。PortDock 不会发送任何内容（用户文件夹、电脑名称、MAC 地址的末尾部分和公网 IP 均会隐藏）。

界面语言：12 种——韩语、英语、日语、德语、西班牙语、葡萄牙语（巴西）、波兰语、法语、越南语、土耳其语、意大利语和印度尼西亚语。首次启动时会遵循 Windows 显示语言（其他语言将使用英语）；可在标题栏或 Settings 中更改。帮助内容提供韩语和英语版本，因此使用其他界面语言时会显示英语帮助。

网站：https://portdock.dev

下载

从**GitHub Releases** 获取最新版本。文件名不会更改，因此这些链接始终指向最新版本：

工具	安装程序	便携版
Serial	PortDock-Serial-setup.exe	PortDock-Serial-portable.zip
Modbus Slave	PortDock-Modbus-Slave-setup.exe	PortDock-Modbus-Slave-portable.zip
TCP	PortDock-TCP-setup.exe	PortDock-TCP-portable.zip
UDP	PortDock-UDP-setup.exe	PortDock-UDP-portable.zip
Simulator	PortDock-Simulator-setup.exe	PortDock-Simulator-portable.zip
Net Scan	PortDock-Net-Scan-setup.exe	PortDock-Net-Scan-portable.zip
Modbus Master	PortDock-Modbus-Master-setup.exe	PortDock-Modbus-Master-portable.zip
SCPI	PortDock-SCPI-setup.exe	PortDock-SCPI-portable.zip
Plot	PortDock-Plot-setup.exe	PortDock-Plot-portable.zip
Port Inspector	PortDock-Port-Inspector-setup.exe	PortDock-Port-Inspector-portable.zip
PLC Simulator	PortDock-PLC-Simulator-setup.exe	PortDock-PLC-Simulator-portable.zip
Hardware Tester	PortDock-Hardware-Tester-setup.exe	PortDock-Hardware-Tester-portable.zip

Windows 10/11，x64。

面向 AI 客户端的 MCP 服务：PortDock-MCP.mcpb（在 Claude Desktop 中打开以安装）或 PortDock-MCP.zip（portdock-mcp.exe——将客户端的 command 指向该文件）。设置指南：portdock.dev/en/guides/portdock-mcp/。

使用 Scoop（便携版）：scoop bucket add portdock https://github.com/portdock/scoop-bucket → scoop install portdock/portdock-serial（MCP 服务：portdock/portdock-mcp；应用名称：scoop-bucket）。

安装程序还是便携版？

• 安装程序（-setup.exe）— 仅为当前用户安装，因此无需管理员权限。会在 PortDock 下添加开始菜单项和卸载程序。
• 便携版（-portable.zip）— 解压到任意位置（U 盘、共享文件夹等），然后运行 exe。不会安装任何内容；设置保存在 exe 旁边的 portdock-data 文件夹中。该文件夹必须可写入。

“Windows 已保护你的电脑”

这些构建版本目前尚未进行代码签名，因此 Microsoft Defender SmartScreen 可能会在首次运行时发出警告。点击更多信息 → 仍要运行。在此之前，你可以检查文件是否为我们发布的版本：

Get-FileHash .\PortDock-Serial-setup.exe -Algorithm SHA256

将结果与同一发行版所附 SHA256SUMS.txt 中对应文件名的那一行进行比较（文件名前的 64 个字符必须匹配；大小写不限）。每个发行版的说明还包含 Microsoft Defender 扫描结果。

WebView2

PortDock 使用 Microsoft Edge WebView2 绘制窗口。它内置于 Windows 11 中，并且通常已安装在保持最新的 Windows 10 上。

• 如果缺少 WebView2，安装程序会自动下载（需要联网）。
• 离线电脑：使用捆绑了 WebView2 运行时的 PortDock-<App>-setup-offline.exe（总大小约 220 MB，而常规安装程序约 4 MB，便携版 zip 约 3 MB）。也可以从 https://developer.microsoft.com/microsoft-edge/webview2/ 安装 Evergreen Standalone Installer（在另一台电脑上下载后复制过来），然后安装或运行 PortDock。便携版不会自行安装 WebView2。

数据保存位置

	设置、命令列表、规则（WebView2 数据）	错误报告
已安装	%LOCALAPPDATA%\dev.portdock.<tool>（例如 dev.portdock.serial）	%LOCALAPPDATA%\dev.portdock.<tool>\reports
便携版	exe 旁边的 portdock-data\	exe 旁边的 portdock-data\reports\<tool>（如果该文件夹不可写入：则与已安装版本相同）

“设置” → 导出设置 会将所有内容保存为一个 JSON 文件，你可以将它移到另一台电脑。日志文件会保存到你选择的位置。

检查

每次推送和拉取请求都会在 Windows 上进行检查（ci.yml）：所有 12 个应用的前端构建和类型检查、346 项 Node 测试（shared/、应用、工具）、设备寄存器映射检查（86 台设备、3427 个寄存器）、将警告视为错误的 cargo clippy、467 项 Rust 测试（运行 459 项，忽略 8 项）、第三方声明和安装程序文本检查，以及网站检查、测试和构建，随后还会检查构建后的页面（标题、链接、结构化数据、站点地图）。代码组织方式：docs/ARCHITECTURE.md · 贡献方式：CONTRIBUTING.md。

从源代码构建

要求：Windows 10/11、Node.js 22+、Rust（stable、MSVC）、包含“使用 C++ 的桌面开发”的 Visual Studio Build Tools、WebView2。

git clone https://github.com/portdock/PortDock
cd PortDock
npm install

npm run serial            # run in development mode (also: modbus-slave, tcp, udp, simulator, netscan, modbus-master, scpi, plot, port-inspector, plc-simulator, hw-tester)
npm run build:serial      # installer → target\release\bundle\nsis\
cargo test --workspace    # tests

# portable build (data next to the exe)
npm run tauri -w portdock-serial -- build --no-bundle --config "$PWD\tools\portable.conf.json"

目录结构：apps/<tool>（各工具的窗口和 Tauri 外壳）、crates/core（共享 Rust：校验和、HEX/ASCII、分帧、Modbus、自动回复、会话）、crates/mcp（PortDock MCP — docs/mcp.md）、shared/（共享 UI）、site/（portdock.dev）。发行流程：docs/release.md。

代码签名政策

状态：目前未签名。 当前发行版本尚未签名。我们计划再次申请开源签名计划（例如 SignPath Foundation）；签名工作开始后，将适用以下范围和角色。

• 签名内容：仅 PortDock 自有程序，由 GitHub Actions (release.yml) 从此仓库构建。每次发布都会先经人工批准，再进行签名。
• 团队角色——PortDock 目前只有一名维护者，负责所有角色（组织成员名单不公开）：
  • 提交者和审阅者（作者、审阅者）：维护者——合并他人提交的拉取请求前会先进行审阅
  • 批准者：维护者
• 隐私：除非用户或安装、操作此程序的人明确提出请求，否则此程序不会向其他联网系统传输任何信息。设备流量只会流向你指定的位置。只有在你启动服务器时，它们才会监听：串口共享（默认使用 TCP 7000）、Modbus TCP ↔ RTU 网关（默认使用 TCP 502）和 PLC Simulator（MC 使用 TCP 5000，XGT 使用 TCP 2004 / UDP 2005）仅监听 127.0.0.1，除非你启用「允许其他电脑连接」；Modbus Slave TCP、TCP server/relay 和 Simulator 监听其地址框中指定的地址（首次运行时，来自 0.10.0 的默认地址是 127.0.0.1——如需供其他电脑连接，请选择 0.0.0.0 或某个网络适配器的地址；设置会保存）；UDP 默认监听 0.0.0.0（它必须接收设备回复）——详见 SECURITY.md。以下内容只写入此电脑（应用存储——导出设置会将其复制到文件中——或你选择的文件；绝不会发送）：Net Scan 基线（每台设备的 IP、完整 MAC 地址、主机名和开放端口）、Port Inspector 保存的检查结果（最多 20 条，包括网络适配器 IP 和网关；不包含序列号和电脑名称）、Modbus Master 设备设置备份（JSON/CSV）、Modbus Master 和 Plot 中的告警 CSV 日志，以及 Hardware Tester USB 日志（设备名称和 VID:PID，不含序列号）。仅在录制期间，Hardware Tester 会 ping 网关和一个由你选择的互联网地址（默认是 1.1.1.1，也可以是 8.8.8.8 或你自己的地址），并在 DNS 服务器查询一个名称（默认是 example.com）；在 Windows 11 24H2 及更高版本上，读取 Wi-Fi 信号（仅在你按下相应按钮时）需要 Windows 位置权限；Bluetooth 设备名称只会显示在屏幕上，不会保存或发送。只有在你按下「！」报告窗口中的发送按钮，或将自动错误报告设为自动发送时，错误报告才会发送到 Sentry（默认：崩溃后询问）。只有在首次运行时选择发送，或在设置中启用发送使用情况统计信息（默认：关闭）时，匿名使用情况统计信息（功能使用次数、打开时长、程序/Windows 版本、显示语言、已安装/便携版——绝不包含流量、IP 地址、端口、COM 名称、文件路径或电脑/用户/设备名称）才会在你关闭窗口时发送到 Aptabase（欧盟）。仅当你在设置中启用*检查新版本（每天一次）*时，程序才会每天向 GitHub API (api.github.com) 查询最新版本（不发送数据，不下载或安装任何内容；默认：关闭）。如果缺少 WebView2，在线安装程序会从 Microsoft 下载它。标题栏中的「AI」按钮（用于复制并向 AI 提问）只会将预览文本放入剪贴板，不会发送任何内容——粘贴后，文本才会发送到相应的 AI 服务。用户文件夹、电脑名称、MAC 地址的最后 3 个字节和公网 IP 都会隐藏；只有在你选择时，才会隐藏私网 IP；文本上限为 8,000 个字符。详情：隐私政策 · Sentry 隐私政策 · Aptabase 隐私政策 · GitHub 隐私声明 · Microsoft 隐私声明（WebView2）。安装程序会在许可证页面显示此声明。

许可证

版权所有 (C) 2026 PortDock

PortDock 是自由软件：您可以根据GNU 通用公共许可证第 3 版（许可证）的条款重新分发和／或修改它。它不提供任何担保。

设备寄存器映射数据（data/devices）及其数据集包根据 CC BY 4.0（data/devices/LICENSE）授权。

第三方组件及其许可证列于 THIRD_PARTY_NOTICES.txt 中，该文件也会随每个程序一同提供。