# PortDock MCP

> PortDock MCP is a free MCP server for developer tools. Reads COM ports, Modbus, MC and SCPI devices on Windows; writes only to simulators. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Windows, CLI
- **Website:** https://portdock.dev/en/guides/portdock-mcp/
- **Repository:** https://github.com/portdock/portdock
- **MCP Registry name:** io.github.portdock/portdock-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Built for people who debug field hardware with an AI client, this windowless Windows server lists COM ports and inspects a port's driver, problem code, USB path, power saving and latency timer. It can listen on a serial port for up to 10 seconds without sending anything, run one Modbus read (function codes 01-04 over TCP, RTU or RTU over TCP), an MC 3E binary batch read, or a SCPI query ending in a question mark. Reset and self-test commands are refused.

The two write tools, modbus_write_sim and mc_write_sim, accept only localhost addresses. From 0.10.0 the Modbus write also checks that the device's vendor name begins with PortDock. The author warns that a relay running on the PC could still forward a write to real equipment. Calls are logged locally, limited to 120 a minute, and nothing is sent anywhere.

Install the .mcpb file in Claude Desktop, unzip it for other clients, or use Scoop. It is not code-signed yet.

## Features

- **COM port inspection:** Lists ports and reports driver, USB path and latency settings.
- **Industrial reads:** Reads Modbus, MC protocol and SCPI values from named devices.
- **Simulator-only writes:** Refuses writes to anything but localhost simulators.
- **Network checks:** Pings hosts and reports adapter settings and firewall profiles.
- **Local call log:** Keeps a session log on the PC and sends nothing out.
- **Rate limits:** Limits calls to 120 a minute and one per 100 ms per target.

## Good for

- Check why a USB serial adapter is misbehaving
- Read a PLC register through an assistant
- Practise Modbus or MC writes against a simulator
- Query a lab instrument with SCPI

## Install

### Claude Code (Terminal)

```sh
claude mcp add portdock-mcp -- npx -y https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "portdock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "portdock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "portdock-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "portdock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "portdock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb"
      ]
    }
  }
}
```

## Tools

- `ports_list`: Lists COM ports.
- `port_inspect`: Reports one port's driver, problem code, USB path, power saving and latency timer.
- `serial_read`: Opens a port and listens for up to 10 seconds.
- `modbus_read`: Performs one Modbus FC 01-04 read.
- `mc_read`: Performs an MC 3E binary batch read.
- `scpi_query`: Sends one SCPI query ending in a question mark.
- `ping`: Pings a host up to 10 times.
- `net_adapters`: Reports adapter settings, power saving and firewall profiles.
- `device_map_get`: Returns built-in device register maps.
- `modbus_write_sim`: Writes Modbus values to a local simulator only.
- `mc_write_sim`: Writes MC protocol values to a local simulator only.

## FAQ

### Can it write to real devices?

No. Write tools accept only 127.0.0.1, ::1 and localhost, though a relay on the PC could forward them.

### Is it free?

The guide lists the MCP server as free.

### Which platform does it run on?

Windows.

### Is it signed?

Not yet, so company security policy may block it.

### Is PortDock MCP free?

Yes. PortDock MCP is free to use.

### How do I add PortDock MCP to Claude Code?

Run this command in your terminal: claude mcp add portdock-mcp -- npx -y https://github.com/portdock/PortDock/releases/download/v0.11.0/PortDock-MCP.mcpb

### What are the best alternatives to PortDock MCP?

The closest alternatives to PortDock MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/portdock-mcp
