Miaomiao Serial MCP Server

Claude Code MCP 服务，用于通过串口调试目标设备。

安装

将整个 miaomiao_serial 文件夹拷贝到目标电脑，例如：

D:\miaomiao_serial\

配置 Claude Code

在 Claude Code 中添加 MCP 服务：

claude mcp add --transport stdio miaomiao_serial -- python "D:\miaomiao_serial\serial_stdio_server.py"

或指定端口和波特率：

claude mcp add --transport stdio miaomiao_serial -- python "D:\miaomiao_serial\serial_stdio_server.py" -- --port COM17 --baudrate 115200

可用工具

工具	功能
serial_connect	连接到串口
serial_disconnect	断开连接
serial_send	发送命令到设备
serial_read	读取缓冲区数据
serial_list_ports	列出可用串口
serial_status	获取连接状态和健康信息
serial_clear_buffer	清空数据缓冲区

使用示例

You: Connect to COM17 and run "date" on the device
Claude: [使用 serial_connect 连接]
       [使用 serial_send 发送 "date"]
       [使用 serial_read 读取输出]

You: Show me the process list
Claude: [使用 serial_send 发送 "top -n 1"]
       [返回进程列表]

You: What's the current buffer status?
Claude: [使用 serial_status]
       返回健康信息：连接状态、字节数、错误计数等

特性

• 线程安全的串口读写
• 自动处理高速数据流（缓冲区上限10000行）
• 多编码支持（UTF-8 / Latin-1）
• 错误自动重连
• 健康状态监控

目录结构

miaomiao_serial/
├── serial_stdio_server.py   # MCP 主程序
├── pyserial/                # 串口库
│   ├── serial/
│   │   └── ...
│   └── pyserial-3.5.dist-info/
└── README.md                # 本文件

感谢

https://github.com/Htboss11/copilot-serial-tool