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

## 系统架构

MCP2Serial 系统架构图

## 工作流程

MCP2Serial 工作流程图

## 项目愿景 MCP2Serial 将串口设备接入AI大模型的项目，它通过 Model Context Protocol (MCP) 将物理世界与 AI 大模型无缝连接。最终实现： - 用自然语言控制你的硬件设备 - AI 实时响应并调整物理参数 - 让你的设备具备理解和执行复杂指令的能力 ## 主要特性 - **智能串口通信** - 自动检测和配置串口设备用户也可指定串口号 - 支持多种波特率（默认 115200） - 实时状态监控和错误处理 - **MCP 协议集成** - 完整支持 Model Context Protocol - 支持资源管理和工具调用 - 灵活的提示词系统 ## 支持的客户端 MCP2Serial 支持所有实现了 MCP 协议的客户端，包括： | 客户端 | 特性支持 | 说明 | |--------|----------|------| | Claude Desktop | 完整支持 | 推荐使用，支持所有 MCP 功能 | | Continue | 完整支持 | 优秀的开发工具集成 | | Cline | 资源+工具 | 支持多种 AI 提供商 | | Zed | 基础支持 | 支持提示词命令 | | Sourcegraph Cody | 资源支持 | 通过 OpenCTX 集成 | | Firebase Genkit | 部分支持 | 支持资源列表和工具 | ## 支持的 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](https://raw.githubusercontent.com/mcp2everything/mcp2serial/main/install.py) ```bash python install.py ``` #### macOS用户 ```bash # 下载安装脚本 curl -O https://raw.githubusercontent.com/mcp2everything/mcp2serial/main/install_macos.py # 运行安装脚本 python3 install_macos.py ``` #### Ubuntu/Raspberry Pi用户 ```bash # 下载安装脚本 curl -O https://raw.githubusercontent.com/mcp2everything/mcp2serial/main/install_ubuntu.py # 运行安装脚本 python3 install_ubuntu.py ``` 安装脚本会自动完成以下操作： - ✅ 检查系统环境 - ✅ 安装必要的依赖 - ✅ 创建默认配置文件 - ✅ 配置Claude桌面版（如果已安装） - ✅ 检查串口设备 ### 手动分步安装依赖 ```bash 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无需此步。使用默认配置文件： ```json { "mcpServers": { "mcp2serial": { "command": "uvx", "args": [ "mcp2serial" ] } } } ``` > 注意：修改配置后需要重启Cline或者Claude客户端软件配置串口和命令：注意下面的配置默认为COM11 需要根据实际进行修改 ```yaml # 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: - "