🔌 MCP STM32 Controller Server / MCP STM32 控制器服务器

Управляйте микроконтроллером STM32 через MCP (Model Context Protocol). ИИ-ассистенты могут читать/записывать GPIO, управлять светодиодом, считывать данные АЦП и работать с OLED-дисплеем — всё это через естественный русский язык.

通过 MCP（Model Context Protocol） 协议控制 STM32 微控制器。AI 助手可以调用本服务提供的工具来读写 STM32 的 GPIO、控制 LED、读取 ADC、操作 OLED 屏幕等。

Архитектура

AI Assistant (Claude) ←→ MCP Server (this program) ←→ UART ←→ STM32 firmware

Для связи используется построчный JSON-протокол: каждый JSON-объект — на отдельной строке, строки завершаются символом \n.

Быстрый старт

1. Установка зависимостей

pip install -r requirements.txt

2. Подключение оборудования

• STM32 USART1: PA9 (TX), PA10 (RX)

• Подключите к компьютеру через USB-TTL модуль

• Прошейте на устройстве подходящую прошивку (реализующую описанный ниже построчный JSON-протокол)

3. Запуск сервера

# auto-detect the serial port
python main.py

# specify a serial port
python main.py --port COM3

# SSE mode (HTTP service)
python main.py --sse --port COM3

Инструменты

Ресурсы

Конфигурация

Через переменные окружения или аргументы командной строки:

Интеграция с Claude Desktop

Отредактируйте claude_desktop_config.json:

{
  "mcpServers": {
    "stm32": {
      "command": "python",
      "args": ["C:/path/to/mcp-stm32-server/main.py", "--port", "COM3"],
      "env": {}
    }
  }
}

Wire-протокол (JSON-строки)

Каждая строка — независимый JSON-объект. Прошивка просто отвечает JSON-строкой с соответствующим id.

Запрос:

{"id":1,"cmd":"set_led","args":{"brightness":75}}

Ответ об успехе:

{"id":1,"status":"ok","data":{"brightness":75}}

Ответ об ошибке:

{"id":1,"status":"error","msg":"brightness must be 0-100"}

Договор для прошивки: на каждый полученный запрос отвечайте одной JSON-строкой с тем же id, содержащей status ("ok" / "error") и либо data, либо msg. Невалидные JSON-строки в журнале запуска клиент автоматически пропускает.

Лицензия

MIT License.

架构

AI 助手 (Claude) ←→ MCP Server (本程序) ←→ 串口 ←→ STM32 固件

通信使用 JSON 行协议，为一个人的对象的一个 JSON 对象，以 \n 结尾。

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 连接硬件

• STM32 的 USART1：PA9(TX)，PA10(RX)

• 通过 USB-TTL 模块连接电脑

• 在设备端烧录实现下述 JSON 行协议的配套固件

3. 启动服务

# 自动检测串口
python main.py

# 指定串口
python main.py --port COM3

# SSE 模式（HTTP 服务）
python main.py --sse --port COM3

工具列表

资源

配置

通过环境变量或命令行参数：

与 Claude Desktop 集成

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "stm32": {
      "command": "python",
      "args": ["C:/path/to/mcp-stm32-server/main.py", "--port", "COM3"],
      "env": {}
    }
  }
}

协议格式（JSON 行）

每一行是一个独立的 JSON 对象。固件只需回一个 id 相同的 JSON 行即可。

请求：

{"id":1,"cmd":"set_led","args":{"brightness":75}}

成功响应：

{"id":1,"status":"ok","data":{"brightness":75}}

错误响应：

{"id":1,"status":"error","msg":"brightness must be 0-100"}

固件约定：收到每条请求后，回一行包含相同 id 的 JSON，含 status（"right" / "error"）以及 data 或 msg。启动时的非 JSON 日志行会被客户端自动跳过。

许可证

MIT License。