Skip to content
MCP server

Serial MCP Server

Let AI agents interact with serial devices — list ports, connect, send, and read.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.3
Listing updated
5 days ago

About Serial MCP Server

Serial MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add serial-mcp-server -- uvx serial-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "serial-mcp-server": {
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "serial-mcp-server": {
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "serial-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "serial-mcp-server": {
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "serial-mcp-server": {
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SERIAL_MCP_MAX_CONNECTIONSMaximum simultaneous open serial connections (default 10)
  • SERIAL_MCP_PLUGINSPlugin policy: 'all' or comma-separated plugin names. Unset = disabled.
  • SERIAL_MCP_MIRRORPTY mirror mode: 'off' (default), 'ro' (read-only), or 'rw' (read-write). macOS/Linux only.
  • SERIAL_MCP_MIRROR_LINKBase path for PTY symlinks (default /tmp/serial-mcp when mirror is enabled). Connections get numbered: /tmp/serial-mcp0, /tmp/serial-mcp1, etc.
  • SERIAL_MCP_TOOL_SEPARATORTool name separator character (default '.'). Set to '_' for clients that reject dots (e.g. Cursor).

Pricing

Open source

Serial MCP Server FAQ

Is Serial MCP Server free?

Yes. Serial MCP Server is open source, so you can use and self-host it for free.

How do I add Serial MCP Server to Claude Code?

Run this command in your terminal: claude mcp add serial-mcp-server -- uvx serial-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers