日本語 | English

语 新 新 新 新 新 新 新 新

构 构 构

MCP2Serialシステム

業務の流れ

MCP2Serial 構造体

ビジョン

MCP2Serial 将 串 串로 大 大 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 最 日本語 ENGLISH

• AI 时整数 让你 备 备 备

主要な特性

• 知能急口通信 自 自 自 户 户 户

• 多色波特分率(115200) 时 时 和 和 和

• **MCP 集成

• 整形整形外科 资 和 提示 提示 提示

端 端

MCP2Serial 所有 所有 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端

| お客様の声 | お問い合わせ| | クロード・デスクトップ | 整形 | 推荐使用料 | | Continue | 完 完 完 完 完 完 完 完 完 完 完 完 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Cline | 公益財団法人 秋田県国際交流協会 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | 提示 | | Sourcegraph Cody | 伊藤忠商事株式会社 | 支持 | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

人工知能モデル

得 端 端 シリアル 可 以 同 同

#####################################################################################################

• OpenAI(GPT-4、GPT-3.5)
• Anthropic クロード
• Googleのジェミニ
• AWSの岩盤
• AzureのOpenAI
• Google Cloud VertexのAI

###[地の模型]

• LM Studio のモデル 支持 的 的 的
• 任用宗者OpenAI API

################################################################################################################################################################################################################################################################ Python3.11 または高版本 Claude デスクトップ または Cline

始 始 始 始

##1. 安装

#####Windows 用 用 用 下载 install.py

macOS用

####Ubuntu/Raspberry Pi 用 用 用 用

安装脚本会自动以下操作: ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅

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