英文 |简体中文

通过自然语言控制硬件，开启物联网新纪元

系统架构

MCP2Serial 系统架构图

工作流程

MCP2Serial 工作流程图

项目愿景

MCP2Serial 将串口设备接入AI大模型的项目，它通过 Model Context Protocol （MCP） 将物理世界与 AI 大模型无缝连接。最终实现：

• 用自然语言控制你的硬件设备
• AI 实时响应并调整物理参数
• 让你的设备具备理解和执行复杂指令的能力

主要特性

• 智能串口通信

• 自动检测和配置串口设备 用户也可指定串口号

• 支持多种波特率（默认 115200）

• 实时状态监控和错误处理

• MCP 协议集成

• 完整支持 模型上下文协议

• 支持资源管理和工具调用

• 灵活的提示词系统

支持的客户端

MCP2Serial 支持所有实现了 MCP 协议的客户端，包括：

支持的 AI 模型

得益于灵活的客户端支持，MCP2Serial 可以与多种 AI 模型协同工作：

云端模型

• OpenAI（GPT-4，GPT-3.5）
• 拟人克劳德
• 谷歌双子座
• AWS 基岩
• Azure OpenAI
• 谷歌云顶点人工智能

本地模型

• LM Studio 支持的所有模型
• Ollama 支持的所有模型
• 任何兼容 OpenAI API 的模型

准备

Python3.11 或更高版本 Claude Desktop 或 Cline

快速开始

1.安装

Windows用户

下载 install.py

macOS用户

Ubuntu/Raspberry Pi用户

安装脚本会自动完成以下操作：

• ✅ 检查系统环境
• ✅ 安装必要的依赖
• ✅ 创建默认配置文件
• ✅ 配置Claude桌面版（如果已安装）

MCP2Serial: 连接物理世界与AI大模型的桥梁

English | 简体中文

系统架构

工作流程

项目愿景

MCP2Serial 将串口设备接入AI大模型的项目，它通过 Model Context Protocol (MCP) 将物理世界与 AI 大模型无缝连接。最终实现：

• 用自然语言控制你的硬件设备
• AI 实时响应并调整物理参数
• 让你的设备具备理解和执行复杂指令的能力

主要特性

• 智能串口通信

  • 自动检测和配置串口设备 用户也可指定串口号
  • 支持多种波特率（默认 115200）
  • 实时状态监控和错误处理

• MCP 协议集成

  • 完整支持 Model Context Protocol
  • 支持资源管理和工具调用
  • 灵活的提示词系统

支持的客户端

MCP2Serial 支持所有实现了 MCP 协议的客户端，包括：

支持的 AI 模型

得益于灵活的客户端支持，MCP2Serial 可以与多种 AI 模型协同工作：

云端模型

• OpenAI (GPT-4, GPT-3.5)
• Anthropic Claude
• Google Gemini
• AWS Bedrock
• Azure OpenAI
• Google Cloud Vertex AI

本地模型

• LM Studio 支持的所有模型
• Ollama 支持的所有模型
• 任何兼容 OpenAI API 的模型

准备

Python3.11 或更高版本 Claude Desktop 或 Cline

快速开始

1. 安装

Windows用户

下载 install.py

python install.py

macOS用户

# 下载安装脚本
curl -O https://raw.githubusercontent.com/mcp2everything/mcp2serial/main/install_macos.py

# 运行安装脚本
python3 install_macos.py

Ubuntu/Raspberry Pi用户

# 下载安装脚本
curl -O https://raw.githubusercontent.com/mcp2everything/mcp2serial/main/install_ubuntu.py

# 运行安装脚本
python3 install_ubuntu.py

安装脚本会自动完成以下操作：

• ✅ 检查系统环境
• ✅ 安装必要的依赖
• ✅ 创建默认配置文件
• ✅ 配置Claude桌面版（如果已安装）
• ✅ 检查串口设备

手动分步安装依赖

windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
MacOS
curl -LsSf https://astral.sh/uv/install.sh | sh

主要依赖uv工具，所以当python和uv以及Claude或Cline安装好后就可以了。

基本配置

在你的 MCP 客户端（如 Claude Desktop 或 Cline）配置文件中添加以下内容： 注意：如果使用的自动安装那么会自动配置Calude Desktop无需此步。 使用默认配置文件：

{
    "mcpServers": {
        "mcp2serial": {
            "command": "uvx",
            "args": [
                "mcp2serial"
            ]
        }
    }
}

注意：修改配置后需要重启Cline或者Claude客户端软件

配置串口和命令： 注意下面的配置默认为COM11 需要根据实际进行修改

# config.yaml
serial:
  port: COM11  # 或自动检测
  baud_rate: 115200  # 可选，默认 115200
  timeout: 1.0  # 可选，默认 1.0
  read_timeout: 1.0  # 读取超时时间，1秒内不应答则报错
  response_start_string: OK  # 可选，串口应答的开始字符串，默认为OK

commands:
  set_pwm:
    command: "PWM {frequency}\n"
    need_parse: false
    prompts:
      - "把PWM调到{value}"

配置说明

配置文件位置

配置文件（config.yaml）可以放在不同位置，程序会按以下顺序查找：

1. 当前工作目录（适合开发测试）

• 路径：./config.yaml