PortDock MCP

PortDock

[CI] [License: GPL-3.0] [Release] [Windows 10/11]

한국어

Free communication tools for testing field hardware on Windows. Each tool is a separate, small download; they share the same communication and decoding core.

All twelve apps: the «AI» button in the header copies the current situation (connection settings, errors, recent traffic or check results) to the clipboard as text to paste into an AI chat. PortDock sends nothing (user folders, PC names, the last part of MAC addresses and public IPs are hidden).

Screen languages: 12 — Korean, English, Japanese, German, Spanish, Portuguese (Brazil), Polish, French, Vietnamese, Turkish, Italian and Indonesian. The first start follows the Windows display language (any other language starts in English); change it in the header or Settings. Help comes in Korean and English, so other screen languages show the English help.

Website: https://portdock.dev

Download

Get the latest version from GitHub Releases. File names never change, so these links always point to the newest release:

Windows 10/11, x64.

MCP server for AI clients: PortDock-MCP.mcpb (open in Claude Desktop to install) or PortDock-MCP.zip (portdock-mcp.exe — point your client's command at it). Setup: portdock.dev/en/guides/portdock-mcp/.

With Scoop (portable edition): scoop bucket add portdock https://github.com/portdock/scoop-bucket → scoop install portdock/portdock-serial (MCP server: portdock/portdock-mcp; app names: scoop-bucket).

Installer or portable?

• Installer (-setup.exe) — installs for the current user only, so no administrator rights are needed. Adds a Start menu entry under PortDock and an uninstaller.
• Portable (-portable.zip) — unzip anywhere (a USB stick, a shared folder) and run the exe. Nothing is installed; settings stay in the portdock-data folder next to the exe. The folder must be writable.

"Windows protected your PC"

The builds are not code-signed yet, so Microsoft Defender SmartScreen may warn on first run. Click More info → Run anyway. Before you do, you can check that the file is the one we published:

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

Compare the result with the line for the same file name in SHA256SUMS.txt attached to the same release (the 64 characters before the file name must match; case does not matter). Each release notes also include the Microsoft Defender scan result.

WebView2

PortDock uses Microsoft Edge WebView2 to draw its window. It is built into Windows 11 and is normally present on up-to-date Windows 10.

• The installer downloads WebView2 automatically if it is missing (this needs internet).
• Offline PCs: use PortDock-<App>-setup-offline.exe, which bundles the WebView2 runtime (about 220 MB in total, against about 4 MB for the regular installer and about 3 MB for the portable zip). Alternatively install the Evergreen Standalone Installer from https://developer.microsoft.com/microsoft-edge/webview2/ (download it on another PC and copy it over), then install or run PortDock. The portable edition never installs WebView2 by itself.

Where data is kept

Settings → Export settings saves everything to one JSON file you can move to another PC. Log files go wherever you choose.

Checks

Every push and pull request is checked on Windows (ci.yml): frontend build and type check of all twelve apps, 346 Node tests (shared/, apps, tools), the device register map check (77 devices, 2987 registers), cargo clippy with warnings as errors, 467 Rust tests (459 run, 8 ignored), third-party notice and installer text checks, and the website check, tests and build followed by a check of the built pages (titles, links, structured data, sitemap). How the code is organised: docs/ARCHITECTURE.md · how to contribute: CONTRIBUTING.md.

Build from source

Requirements: Windows 10/11, Node.js 22+, Rust (stable, MSVC), Visual Studio Build Tools with "Desktop development with C++", WebView2.

git clone https://github.com/portdock/PortDockcd PortDocknpm 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"

Layout: apps/<tool> (each tool's window and Tauri shell), crates/core (shared Rust: checksums, HEX/ASCII, framing, Modbus, auto-reply, sessions), crates/mcp (PortDock MCP — docs/mcp.md), shared/ (shared UI), site/ (portdock.dev). Release procedure: docs/release.md.

Code signing policy

Status: not signed at the moment. Current releases are not signed. We plan to apply again to an open-source signing program (such as SignPath Foundation); the scope and roles below will apply once signing starts.

• What is signed: only PortDock's own programs, built by GitHub Actions (release.yml) from this repository. Every release is approved manually before signing.
• Team roles — PortDock currently has a single maintainer who holds every role (the organisation's member list is not public):
  • Committers and reviewers (Authors, Reviewers): the maintainer — pull requests from others are reviewed before merging
  • Approvers: the maintainer
• Privacy: This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. Device traffic goes only where you point it. Servers listen only when you start them: Serial port sharing (TCP 7000 by default), the Modbus TCP ↔ RTU gateway (TCP 502 by default) and PLC Simulator (MC on TCP 5000, XGT on TCP 2004 / UDP 2005) listen on 127.0.0.1 only unless you turn on «Allow other PCs to connect»; Modbus Slave TCP, TCP server/relay and Simulator listen on the address in their address box (from 0.10.0 127.0.0.1 on first run — pick 0.0.0.0 or an adapter's address for other PCs; saved settings are kept), and UDP on 0.0.0.0 by default (it has to receive device replies) — see SECURITY.md. Written only to this PC (app storage — which Export settings copies into its file — or files you choose; never sent): Net Scan baselines (IP, full MAC address, host name and open ports of each device), Port Inspector saved checks (up to 20, including network adapter IPs and gateway; serial numbers and PC name left out), Modbus Master device settings backups (JSON/CSV), alarm CSV logs in Modbus Master and Plot, and the Hardware Tester USB log (device names and VID:PID, no serial numbers). Hardware Tester, only while recording, pings the gateway and one internet address you choose (1.1.1.1 by default, 8.8.8.8 or your own) and looks up one name (example.com by default) at the DNS server; reading the Wi-Fi signal (only when you press it) needs Windows location permission on Windows 11 24H2 and later, and Bluetooth device names are shown on screen only, never saved or sent. Error reports go to Sentry only when you press send in the «!» report window or set Automatic error reports to Send automatically (default: Ask after a crash). Anonymous usage statistics (feature use counts, minutes open, program/Windows version, display language, installed/portable edition — never traffic, IP addresses, ports, COM names, file paths or PC/user/device names) go to Aptabase (EU) when you close the window, only if you chose Send when asked on first run or turned on Send usage statistics in Settings (default: off). The update check asks the GitHub API (api.github.com) for the latest release once a day, only if you turn on Check for new versions (once a day) in Settings (no data sent, nothing downloaded or installed; default: off). If WebView2 is missing, the online installer downloads it from Microsoft. The «AI» button in the header (copy for asking AI) puts the preview text on the clipboard only and sends nothing — once pasted it goes to that AI service. User folders, PC names, the last 3 bytes of MAC addresses and public IPs are hidden, private IPs only when you choose, and the text is capped at 8,000 characters. Details: privacy policy · Sentry privacy policy · Aptabase privacy policy · GitHub privacy statement · Microsoft privacy statement (WebView2). The installer shows this notice on its license page.

License

Copyright (C) 2026 PortDock

PortDock is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 (LICENSE). It comes with ABSOLUTELY NO WARRANTY.

The device register map data (data/devices) and its dataset bundle are licensed under CC BY 4.0 (data/devices/LICENSE).

Third-party components and their licenses are listed in THIRD_PARTY_NOTICES.txt, which also ships next to every program.