Serial MCP Server

🚀 串行MCP服務器

這是一款專業的模型上下文協議（MCP）服務器，專為串口通信設計。它為AI助手提供了全面的串行通信能力，可用於嵌入式系統、物聯網設備以及硬件調試等場景，能實現與真實硬件的集成。

🚀 快速開始

前提條件

硬件要求

• 串行設備：STM32、Arduino、ESP32或任何支持UART的設備。
• 連接方式：USB轉串口轉換器或內置USB - UART接口。
• USB線纜：用於將設備連接到PC。

軟件要求

• Rust 1.70及以上版本。
• 串行設備驅動程序（大多數系統可自動檢測）。

安裝

# 從源代碼克隆並構建
git clone https://github.com/adancurusul/serial-mcp-server.git
cd serial-mcp-server
cargo build --release

基本用法

配置MCP客戶端

Claude桌面配置示例

添加到Claude桌面配置文件：

Windows示例：

{
  "mcpServers": {
    "serial": {
      "command": "C:\\path\\to\\serial-mcp-server\\target\\release\\serial-mcp-server.exe",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

macOS/Linux示例：

{
  "mcpServers": {
    "serial": {
      "command": "/path/to/serial-mcp-server/target/release/serial-mcp-server",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

其他工具（如cursor、claude code等）的示例，請參考相應工具的文檔。

✨ 主要特性

• 🚀 生產就緒：與真實硬件集成，擁有5種全面的串行通信工具。
• 🔌 跨平臺支持：支持Windows、Linux、macOS系統，並能自動檢測端口。
• 📡 完整的串行控制：可列出端口、連接設備、發送/接收數據，並進行全面配置。
• 📝 多種數據格式：支持UTF - 8、十六進制、二進制編碼，並具備超時處理功能。
• 🛠️ 硬件集成：已在STM32、Arduino、ESP32等嵌入式系統上進行測試。
• 🤖 AI集成：與Claude等AI助手完美兼容。
• 🧪 全面測試：所有5種工具均已通過真實硬件驗證。
• ⚡ 高性能：基於Tokio異步運行時構建，支持併發連接。

🏗️ 架構

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  Serial MCP      │◄──►│  Serial Device  │
│   (Claude/AI)   │    │  Server          │    │  Hardware       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  Target Device   │
                       │  (STM32/Arduino) │
                       └──────────────────┘

🎯 嘗試STM32演示

我們提供了一個全面的 STM32串行通信演示，展示了所有功能：

# 進入示例目錄
cd examples/STM32_demo

# 構建並運行固件
cargo run --release

# 與MCP服務器配合使用，體驗完整的串行通信

演示展示內容：

• ✅ 交互式串行命令：發送命令並獲取即時響應。
• ✅ 所有5種MCP工具：通過真實的STM32硬件進行完整驗證。
• ✅ 硬件控制：LED切換、計數器系統、閃爍模式。
• ✅ 命令接口：帶有交互式命令處理的幫助系統。

📖 查看STM32演示文檔 →

💻 使用示例

基礎用法

與AI助手的使用示例：

列出可用串行端口

請列出系統上可用的串行端口

連接到串行設備

以115200的波特率連接到我的STM32設備的COM19端口

發送交互式命令

發送'H'命令以獲取幫助菜單，然後發送'L'以切換LED

讀取設備響應

在2秒超時時間內讀取串行設備的響應

完整通信測試

請幫我使用我的STM32開發板在COM19端口上測試所有5種MCP串行工具。首先列出端口，然後連接，發送一些命令，讀取響應，最後關閉連接。

🛠️ 完整工具集（5種工具）

所有工具均已通過真實的STM32硬件測試和驗證：

📡 串行通信（5種工具）

✅ 5/5工具 - 真實硬件測試成功率100%

🌍 支持的硬件

串行設備

• STM32：所有具備UART功能的STM32系列。
• Arduino：Uno、Nano、ESP32、ESP8266。
• 嵌入式系統：任何帶有UART/USB - 串行接口的設備。
• 工業設備：Modbus、RS485轉換器。
• 物聯網設備：支持串行通信的傳感器、執行器。
• 其他：任何帶有UART/USB - 串行接口的設備。

串行接口

• USB轉串口：CH340、CH343、FTDI、CP2102。
• 內置USB：帶有USB - CDC的STM32、Arduino Leonardo。
• 硬件UART：直接UART連接。

平臺支持

🏆 生產狀態

✅ 完全實現並測試

當前狀態：生產就緒

• ✅ 完整的串行集成：通過所有5種工具實現與真實硬件的通信。
• ✅ 硬件驗證：在COM19端口上使用STM32 + CH343 USB - 串行進行測試。
• ✅ 交互式通信：完整的雙向命令/響應系統。
• ✅ 多平臺支持：支持Windows、Linux、macOS系統，並能自動檢測。
• ✅ 連接管理：具備強大的連接處理能力和正確的清理機制。
• ✅ AI集成：與MCP協議完美兼容。

🔧 技術細節

串行實現

• 跨平臺：自動檢測和配置端口。
• 多種編碼：支持UTF - 8、十六進制、二進制數據。
• 超時處理：可配置讀寫超時時間。
• 連接池：支持多個併發串行連接。

性能特點

• 端口發現：快速枚舉可用端口。
• 連接速度：快速建立連接。
• 數據吞吐量：高效的數據傳輸，延遲極低。
• 會話穩定性：經過長時間運行測試。

🙏 致謝

感謝以下開源項目：

• serialport-rs - 串行端口通信庫
• rmcp - Rust MCP SDK
• tokio - 異步運行時

📄 許可證

本項目採用MIT許可證。詳情請參閱LICENSE文件。

⭐ 如果這個項目對你有幫助，請給我們點個Star！