How do I use UART MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@UART MCP Server list available serial ports" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

UART MCP Server

by donnel666

Overview Schema Source Related Servers Discussions Admin

Python

Local

UART MCP Server

English | 中文

为 AI 助手提供串口通信能力的 MCP Server。

功能特性

串口管理 - 枚举、打开、关闭和配置串口设备
数据通信 - 支持文本和二进制模式的数据收发
终端会话 - 创建交互式终端会话，支持命令发送和输出读取
热配置 - 支持在不关闭串口的情况下修改配置参数
自动重连 - 设备断开后自动尝试重新连接

Related MCP server: Serial MCP Server

快速开始

提示词配置

为了让 AI 助手优先使用 UART 工具操作串口，建议在项目提示词文件中添加以下内容：

始终使用 uart MCP 工具进行串口操作，包括列出串口、打开/关闭串口、发送/接收数据等。

不同工具的提示词文件位置：

工具	提示词文件
Claude Code	`CLAUDE.md` 或 `.claude/settings.json`
Factory Droid	`AGENTS.md` 或 `.factory/droids/`
Cursor	`.cursor/rules/`
Windsurf	`.windsurfrules`

Claude Code

claude mcp add uart -- uvx --from git+https://github.com/donnel666/uart-mcp.git uart-mcp

Codex CLI

在 ~/.codex/config.toml 中添加：

[mcp_servers.uart]
type = "stdio"
command = "uvx"
args = ["--from", "git+https://github.com/donnel666/uart-mcp.git", "uart-mcp"]

Factory Droid

在项目 .factory/settings.json 或全局 ~/.factory/settings.json 中添加：

{
  "mcpServers": {
    "uart": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/donnel666/uart-mcp.git", "uart-mcp"]
    }
  }
}

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "uart": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/donnel666/uart-mcp.git", "uart-mcp"]
    }
  }
}

可用工具

串口管理

工具	描述
`list_ports`	列出所有可用串口设备
`open_port`	打开指定串口（支持配置波特率、数据位、校验位等）
`close_port`	关闭指定串口
`set_config`	修改已打开串口的配置（热更新）
`get_status`	获取串口当前状态和配置信息

数据通信

工具	描述
`send_data`	向串口发送数据（支持文本/二进制模式）
`read_data`	从串口读取数据（支持文本/二进制模式）

终端会话

工具	描述
`create_session`	创建终端会话（支持配置换行符、本地回显）
`close_session`	关闭终端会话
`send_command`	向终端发送命令
`read_output`	读取终端输出缓冲区
`list_sessions`	列出所有活动会话
`get_session_info`	获取会话详细信息
`clear_buffer`	清空会话输出缓冲区

串口权限

请确保本工具有权限访问串口设备：

Linux:

# 方法1：临时赋予权限
sudo chmod 777 /dev/ttyUSB0

# 方法2：将用户加入 dialout 组（推荐，重新登录后生效）
sudo usermod -aG dialout $USER

macOS:

# 将用户加入 wheel 组
sudo dseditgroup -o edit -a $USER -t user wheel

Windows: 通常无需额外配置，COM 端口默认可访问。

使用示例

基础串口通信

使用 list_ports 查看可用串口
使用 open_port 打开串口，如 /dev/ttyUSB0 或 COM1
使用 send_data 发送数据
使用 read_data 读取响应
使用 close_port 关闭串口

终端会话模式

使用 open_port 打开串口
使用 create_session 创建终端会话
使用 send_command 发送命令
使用 read_output 读取命令输出
使用 close_session 关闭会话

串口配置参数

参数	默认值	可选值
波特率	115200	300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600
数据位	8	5, 6, 7, 8
校验位	N (无)	N (无), E (偶), O (奇), M (标记), S (空格)
停止位	1	1, 1.5, 2
流控制	none	none, xonxoff, rtscts, dsrdtr

配置文件

UART MCP 的配置文件位于：

Linux/macOS: ~/.uart-mcp/
Windows: %APPDATA%\.uart-mcp\

配置文件说明

文件	说明
`config.toml`	全局配置（波特率、超时、流控等默认参数）
`blacklist.conf`	串口黑名单（支持精确匹配和正则表达式）

config.toml 示例

[serial]
baudrate = 115200
bytesize = 8
parity = "N"
stopbits = 1.0

[timeout]
read_timeout = 1000
write_timeout = 1000

[flow_control]
xonxoff = false
rtscts = false
dsrdtr = false

[reconnect]
auto_reconnect = true
reconnect_interval = 5000

[logging]
log_level = "INFO"

blacklist.conf 示例

# 黑名单配置（每行一个规则）
# 支持精确匹配和正则表达式

# 精确匹配
/dev/ttyS0

# 正则表达式匹配所有 COM 端口
COM[0-9]+

注意： 配置文件权限应为 600（仅所有者可读写），否则会报权限错误。

本地开发

# 克隆仓库
git clone https://github.com/donnel666/uart-mcp.git
cd uart-mcp

# 安装依赖
uv sync --dev

# 运行服务器
uv run uart-mcp

# 运行测试
uv run pytest

# 代码检查
uv run ruff check src/
uv run mypy src/

系统要求

Python 3.13+
支持的操作系统: Linux, macOS, Windows

许可证

MIT License

Available Tools

14 tools

clear_bufferA

清空指定终端会话的输出缓冲区

Inputs: session_id (required).

close_portB

关闭指定串口连接

Inputs: port (required).

close_sessionB

关闭指定的终端会话

Inputs: session_id (required).

create_sessionB

在已打开串口上创建终端会话，支持配置换行符和本地回显

Inputs: port (required), line_ending, local_echo, buffer_size.

get_session_infoB

获取指定终端会话的详细信息

Inputs: session_id (required).

get_statusA

获取已打开串口的当前状态和配置信息

Inputs: port (required).

list_portsA

列出所有可用串口设备，返回设备路径、描述信息和硬件ID

Inputs: no named parameters.

list_sessionsA

列出所有活动的终端会话

Inputs: no named parameters.

open_portB

打开指定串口，支持自定义配置参数

Inputs: port (required), baudrate, bytesize, parity, +5 more.

read_dataB

从已打开的串口读取数据，支持文本和二进制模式

Inputs: port (required), size, timeout_ms, is_binary.

read_outputC

读取终端输出缓冲区的内容

Inputs: session_id (required), clear.

send_commandC

向终端发送命令，可选择是否自动添加换行符

Inputs: session_id (required), command (required), add_line_ending.

send_dataB

向已打开的串口发送数据，支持文本和二进制模式

Inputs: port (required), data (required), is_binary.

set_configA

修改已打开串口的配置（热更新，无需关闭重开）

Inputs: port (required), baudrate, bytesize, parity, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored 2026-04-29 19:40 across 14 tools

Disambiguation5/5

Each tool has a clearly distinct purpose, with no overlap. read_data vs read_output and send_command vs send_data are differentiated by their descriptions (serial port vs terminal buffer/command).

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with underscores, e.g., open_port, send_data, clear_buffer. No mixing of conventions.

Tool Count5/5

14 tools is well-scoped for a UART server, covering port management, session handling, data transfer, and configuration without being excessive or insufficient.

Completeness5/5

The tool set covers the full lifecycle: opening/closing ports, creating/managing sessions, reading/writing data (text and binary), sending commands, clearing buffers, and retrieving status/info. No obvious gaps.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

DNS-DATA RemoteDeprecated
com.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
File Systems Command Line OS Automation
11
https://mcp.dns-data.com/mcp
GitHub
io.github.github
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Version Control Developer Tools CI/CD & DevOps
1234,437
https://api.githubcopilot.com/mcp/
PC Remote Commander
io.github.pcremotecommander
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
File Systems Command Line Browser Automation
11
https://pc-remote-commander.pcremotecommander.workers.dev/mcp
ZionDesk
app.ziondesk
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
File Systems Command Line Browser Automation
1
https://mcp.ziondesk.app/mcp

Related MCP Servers

MCP Serial Port Tool
Embedded system OS Automation
niusulong
F
license
Not graded
quality
Not graded
maintenance
Enables AI assistants to interact with physical serial port devices across platforms (Windows COM/Linux tty) with support for asynchronous communication, URC pattern recognition, and structured logging.
Updated a year ago (2025-11-15 22:32 UTC)
1
-
Serial MCP Server
Embedded system Developer Tools Testing & QA Tools
es617
A
license
A
quality
C
maintenance
Allows AI agents to interact with serial devices via RS232/UART, enabling port listing, connection, read/write, control line manipulation, and protocol specification for automated debugging and testing.
Updated 8 months ago (2026-03-07 22:09 UTC)
27
65 PyPI
27
MIT
mcp-uart
Embedded system
SamyiHu
A
license
Not graded
quality
C
maintenance
Enables AI agents to communicate with UART/serial devices, offering tools for port management, data read/write, and protocol handling.
Updated a month ago (2026-10-10 09:35 UTC)
MIT
Serial Web Terminal MCP
Command Line Shell Access
WakkeWang
A
license
Not graded
quality
D
maintenance
Enables AI assistants to interact with serial port devices by sending commands, capturing output, and managing connections, with real-time browser-based terminal monitoring.
Updated 3 months ago (2026-08-18 01:13 UTC)
1
MIT

UART MCP Server

功能特性

快速开始

提示词配置

Claude Code

Codex CLI

Factory Droid

Claude Desktop

可用工具

串口管理

数据通信

终端会话

串口权限

使用示例

基础串口通信

终端会话模式

串口配置参数

配置文件

配置文件说明

config.toml 示例

blacklist.conf 示例

本地开发

系统要求

许可证

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

MCP Serial Port Tool

Serial MCP Server

mcp-uart

Serial Web Terminal MCP