XTELL Serial

xtell-serial

关于 XTELL（www.xtell.cn）

深圳市 XTELL Future Technology 提供真正的全栈开发服务：由同一支团队负责软件、电路设计、模具开发和量产。我们的业务涵盖嵌入式软件与硬件、云平台与后端、AI 算法、IoT 解决方案和移动互联网技术。我们提供从概念设计到量产交付的全生命周期服务；硬件与软件的紧密协作，帮助客户快速将产品推向市场并取得商业成功。

可由 AI 助手通过 MCP 操控的图形界面串口终端。
你可以在普通桌面窗口中查看滚动的日志；Claude、Cursor 或任何 MCP 客户端都能读取同一份日志，并向同一端口发送命令。

状态：早期预览版（v0.1）。目前仅支持 Windows。完整的 MCP 配置指南和工具参考见 docs/MCP_SETUP.md（也提供中文版本）。

中文说明

上方窗格显示日志，筛选器（此处为 ERR）会高亮匹配项，并在下方列出。日志为演示数据。

功能介绍

• 完整的串口终端：波特率最高支持 10 Mbaud，支持 UTF-8 / GBK / GB2312 / ASCII、HEX 查看和发送、时间戳、行号。
• 按子字符串或正则表达式实时筛选，支持高亮显示和单独的筛选视图。
• 重复发送、发送历史记录、以追加模式保存到文件、带使用量指示条的 100,000 行缓冲区。
• 英文和中文用户界面：使用菜单栏中 File 旁边的语言选项（ENG / 中文）切换；选择会被记住（首次运行时使用 Windows 显示语言）。
• 可同时打开多个窗口，每个窗口都有自己的名称，适用于连接多个开发板的工作台设置。第一个窗口充当本地枢纽；若它关闭，其他窗口会接管。
• MCP 服务（xtell-serial-mcp）向 AI 客户端提供 14 个工具：列出端口、连接、发送、自动发送、读取接收 / 发送 / 筛选数据（可选时间范围）、设置筛选器、保存到文件、清空缓冲区、检查缓冲区状态。

GUI 和 MCP 服务通过 127.0.0.1:50016 上的本地 TCP 枢纽通信（可通过 XTELL_SERIAL_HUB_PORT 覆盖）。不会监听公共网络接口。

更多截图

从源代码运行

pip install -r requirements.txt
python xtell_serial.py

构建可执行文件（Windows）

pip install pyinstaller
build_exe.bat

这会生成 dist\xtell-serial.exe（GUI）和 dist\xtell-serial-mcp.exe（MCP 服务）。

连接 AI 客户端

将 xtell-serial-mcp.exe（而非 GUI）注册为 MCP 服务。Claude Code 配置示例：

claude mcp add xtell-serial C:\path\to\xtell-serial-mcp.exe

对于 Claude Desktop、Cursor 和其他客户端，将以下内容添加到客户端的 MCP 配置中（参见 mcp_config.example.json）：

{
  "mcpServers": {
    "xtell-serial": {
      "command": "C:\\path\\to\\xtell-serial-mcp.exe",
      "args": []
    }
  }
}

完整的工具参考见 docs/MCP_SETUP.md。

然后向助手提出类似这样的请求：“连接到 115200 波特率的 COM3，发送 AT+GMR，并告诉我模块报告的版本号。”

安全提示

• 助手可以向端口上的设备发送任意字节。请勿将其连接到可能因意外命令而造成危害的硬件。
• 本地枢纽仅接受来自 127.0.0.1 的连接。

许可证

Apache License 2.0，详见 LICENSE。

---

由 XTELL 构建。XTELL 是一家位于深圳的嵌入式软硬件设计公司。