Serial Server

A Model Context Protocol (MCP) server for serial port communication, enabling LLMs to interact with hardware devices via serial connections.

Features

• List available serial ports
• Open/close serial port connections
• Read and write data to serial ports
• Control serial signals (DTR, RTS, CTS, DSR, DCD)
• Support for custom baud rates, data bits, stop bits, and parity
• JSON and Markdown output formats

Installation

# Install from PyPI (when published)
pip install serial-mcp-new

Usage

Running the Server

# Run with stdio transport (default, for local use)
serial-mcp

Config in Claude Code

  "mcpServers": {
    "ssh-mcp": {
      "command": "C:\\Users\\DELL\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\\LocalCache\\local-packages\\Python311\\Scripts\\serial-mcp.exe",
      "args": [],
      "env": {}
    }
  },

Available Tools

Tool	Description
serial_list_ports	List all available serial ports
serial_open	Open a serial port connection
serial_close	Close a serial port connection
serial_write	Write data to a serial port
serial_read	Read data from a serial port
serial_set_signals	Set control signal states
serial_get_signals	Read current signal states
serial_list_connections	List all active connections

Example Workflow

1. List available ports:

   serial_list_ports()
   

2. Open a connection:

   serial_open(port="COM3", baud_rate=115200)
   

3. Write data:

   serial_write(connection_id="conn_1", data="Hello, device!")
   

4. Read response:

   serial_read(connection_id="conn_1", timeout=2.0)
   

5. Close when done:

   serial_close(connection_id="conn_1")
   

Dependencies

• Python 3.10+
• mcp >= 1.6.1
• pyserial >= 3.5
• pydantic >= 2.0.0

License

MIT