uart-mcp - 支持串口管理、數據收發，為AI助手提供串口通信能力的MCP服務器

探索

Uart MCP

為AI助手提供串口通信能力的MCP服務器，支持串口管理、數據收發和終端會話等功能

開發者工具家庭自動化與物聯網 #串口通信 #MCP工具 #硬件交互 #終端會話 .Python

評分 : 2.5分

下載量 : 10.5K

更新時間 : 2025-12-29

打開站點

什麼是UART MCP Server?

UART MCP Server是一個專門為AI助手設計的串口通信工具。它允許AI助手（如Claude、Cursor等）直接與串口設備進行交互，就像人類工程師使用串口調試助手一樣。通過這個工具，AI可以幫你調試嵌入式設備、讀取傳感器數據、控制硬件設備等。

如何使用UART MCP Server?

使用非常簡單：1) 在你的AI工具中配置MCP服務器，2) AI助手會自動獲得串口操作能力，3) 直接告訴AI你想要操作的串口設備或發送的命令，AI就會幫你完成所有技術操作。

適用場景

嵌入式開發調試、物聯網設備管理、硬件設備控制、傳感器數據讀取、自動化測試、工業設備監控等需要與串口設備交互的場景。

主要功能

串口設備管理

自動檢測和列出所有可用的串口設備，支持打開、關閉和配置串口參數

智能數據通信

支持文本和二進制模式的數據收發，AI會自動處理編碼和解碼

交互式終端會話

創建類似終端的環境，可以連續發送命令並讀取響應，適合調試會話

熱配置更新

無需關閉串口即可修改配置參數，如波特率、數據位等

自動重連機制

設備意外斷開時自動嘗試重新連接，確保通信連續性

跨平臺支持

支持Windows、macOS和Linux系統，自動適配不同平臺的串口命名規則

優勢

無需學習複雜串口工具：AI幫你處理所有技術細節

自然語言交互：用說話的方式操作串口設備

自動化能力：AI可以執行復雜的調試流程

跨平臺一致性：在不同操作系統上體驗一致

配置簡單：一次配置，多個AI工具共享

侷限性

需要AI工具支持MCP協議

某些系統需要手動配置串口權限

即時性要求極高的場景可能不如專業工具

二進制數據處理需要明確指令

如何使用

配置AI工具

根據你使用的AI工具（Claude Desktop、Cursor等），在配置文件中添加UART MCP Server

設置串口權限

確保你的用戶賬戶有權限訪問串口設備（不同系統方法不同）

開始使用

重啟AI工具，現在你可以用自然語言讓AI操作串口了

使用案例

調試ESP32開發板

通過串口與ESP32開發板通信，發送AT命令測試Wi-Fi模塊

讀取Arduino傳感器數據

從Arduino讀取溫度傳感器數據並解析

自動化設備測試

自動執行一系列測試命令並記錄結果

常見問題

為什麼AI說沒有找到串口設備？

如何發送十六進制數據？

支持哪些波特率？

數據接收不完整怎麼辦？

如何同時與多個串口設備通信？

🚀 UART MCP Server

UART MCP Server 是一個為 AI 助手提供串口通信能力的服務器。它可以幫助 AI 助手方便地進行串口設備管理和數據通信，支持多種功能特性，如串口管理、數據通信、終端會話等。

✨ 主要特性

串口管理：可以枚舉、打開、關閉和配置串口設備，方便對串口進行操作和管理。
數據通信：支持文本和二進制模式的數據收發，滿足不同類型數據的傳輸需求。
終端會話：能夠創建交互式終端會話，支持命令發送和輸出讀取，實現與串口設備的交互操作。
熱配置：支持在不關閉串口的情況下修改配置參數，提高配置的靈活性。
自動重連：設備斷開後自動嘗試重新連接，確保通信的穩定性。

🚀 快速開始

提示詞配置

為了讓 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"]
    }
  }
}

📦 安裝指南

串口權限

請確保本工具有權限訪問串口設備：

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 關閉會話。

📚 詳細文檔

可用工具

串口管理

工具	描述
`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`	清空會話輸出緩衝區

串口配置參數

參數	默認值	可選值
波特率	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/