Skip to main content
Glama

AT Bridge

MCP server for AI-driven AT command debugging over serial port.

AT Bridge 是一个 Model Context Protocol 服务器,让 AI 助手能够通过 COM/串口直接与 IoT 模组通信,进行 AT 命令调试。内置可维护的芯片平台知识库,实测过的命令自动沉淀。

Features

  • 串口通信 — 自动探测可用 COM 口,支持主流波特率,可配置校验位/流控

  • AT 命令调试 — 发送 AT 命令并解析响应,自动补全 AT 前缀

  • 批量测试 — 一次性发送命令列表,自动分类 PASS/ERR/CME

  • 知识库 — 按芯片平台分层存储 AT 命令(含语法、返回值含义、实测数据),支持搜索和持续积累

  • 双层存储 — 包内 YAML 只读(随版本分发),用户数据写到 %APPDATA%(跨版本保留)

Related MCP server: embedded-serial-mcp

Quick Start

uv sync
uv run python main.py

MCP Configuration

{
  "mcpServers": {
    "at-bridge": {
      "command": "uv",
      "args": ["run", "--directory", "path/to/at_bridge", "python", "main.py"]
    }
  }
}

Tools

Serial Communication

Tool

Description

at_list_ports

枚举 COM/串口,含 VID/PID、制造商、描述

at_auto_detect

自动探测 — 扫描所有端口,试多种波特率,找出响应 AT 的设备

at_configure

配置波特率、数据位、校验位、停止位、流控

at_open_port / at_close_port

打开/关闭串口连接

at_send_command

发送单条 AT 命令,自动补全 AT 前缀,解析响应

at_batch_test

批量测试 — 一次发送命令列表,自动分类结果

Knowledge Base

Tool

Description

at_knowledge_search

按关键词/平台/标签搜索命令库

at_knowledge_list

列出全部命令,可按平台过滤

at_knowledge_add

添加/更新命令到指定芯片平台

at_knowledge_chipsets

查看可用的芯片平台列表

at_knowledge_stats

知识库统计:条目数、来源分布

Chipsets

芯片平台知识库位于 src/at_bridge/chipsets/,按平台分层:

文件

内容

_3gpp.yaml

3GPP 标准 AT 命令(49 条),只读基础库

asr.yaml

ASR 平台私有命令与平台特性

quectel.yaml

移远 EC200x 等私有命令(48 条)

_custom.yaml

用户自定义命令,自动创建于 %APPDATA%/at-bridge/chipsets/

加载顺序:_3gpp → 平台文件 → _custom(后者覆盖同名 key)。

Project Structure

at_bridge/
  main.py                    # Entry point — MCP server on stdio
  src/at_bridge/
    server.py                # MCP server: 12 tool definitions + handlers
    serial_handler.py        # Serial I/O + batch test engine
    knowledge_store.py       # YAML knowledge base CRUD with two-layer storage
    chipsets/                # Platform command libraries
      _3gpp.yaml / asr.yaml / quectel.yaml

Available Tools

12 tools
at_auto_detectA

Auto-detect all available COM ports. Tries common baud rates and sends an AT probe command to find responsive devices. Useful when unsure which port the device is connected to.

Inputs: baudrates, test_command, probe_timeout.

at_batch_testA

Batch-test AT commands. Sends a list of AT commands to the connected device and returns all results with automatic classification (PASS/OK/ERR/CME). Much more efficient than calling at_send_command repeatedly; good for validating a command list from the knowledge base.

Inputs: commands (required), timeout.

at_close_portB

Close the currently opened COM port connection.

Inputs: no named parameters.

at_configureA

Configure serial port parameters (baud rate, data bits, parity, stop bits, flow control). Can be called before or after opening the port.

Inputs: parity, rtscts, timeout, xonxoff, +3 more.

at_knowledge_addA

Add or update an AT command in the knowledge base. Stores in the specified chipset file (e.g. asr, quectel) or _custom. Use at_knowledge_chipsets to see available platforms.

Inputs: key (required), command (required), name, type, +7 more.

at_knowledge_chipsetsA

List available chipset knowledge base files. AI should call this first to know which platforms exist, then use at_knowledge_add to write to the appropriate platform file.

Inputs: no named parameters.

at_knowledge_listA

List all commands in the knowledge base, optionally filtered by source. Shows key, name, and expected response summary.

Inputs: standard.

at_knowledge_statsA

Show knowledge base statistics: total commands, per-source YAML file breakdown, source distribution.

Inputs: no named parameters.

at_list_portsA

List all available COM/serial ports. Returns device name, description, hardware ID, VID/PID.

Inputs: no named parameters.

at_open_portB

Open the specified COM port and establish a serial connection.

Inputs: port (required).

at_send_commandA

Send an AT command to the connected device and read the response. Auto-prepends AT prefix (e.g. 'CSQ' becomes 'AT+CSQ'). Supports standard AT and extended AT+ commands.

Inputs: command (required), read_until.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 12 tools

    Disambiguation4/5

    Tools are mostly distinct, but at_auto_detect and at_list_ports both deal with port discovery and may cause confusion. at_batch_test and at_send_command are clearly differentiated by batch vs single command. Knowledge base tools are well-separated.

    Naming Consistency4/5

    All tools start with 'at_' prefix. Most follow verb_noun pattern (at_open_port, at_list_ports), but knowledge base tools use noun_verb (at_knowledge_add, at_knowledge_list), and at_configure is a standalone verb. Minor inconsistency but overall predictable.

    Tool Count5/5

    12 tools is well-scoped for the domain of AT command interaction and knowledge management. It covers port operations, command sending, and knowledge base without being excessive.

    Completeness4/5

    Core workflow is covered: port detection (auto_detect, list_ports), configuration (configure), open/close, and command sending (single/batch). Knowledge base adds support. Missing possibly a 'read current config' or raw send without AT prefix, but these are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables AI assistants to control GDB debugging sessions, including breakpoint management, thread analysis, and variable inspection, using the GDB/MI protocol.
      22
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A professional MCP server for serial port communication, enabling AI assistants to list, connect, send/receive data, and manage serial connections with embedded systems, IoT devices, and hardware debugging hardware.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Serial communication and protocol analysis MCP server that gives AI coding assistants direct access to serial ports for reading, writing, decoding, and capturing embedded device output.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides comprehensive debugging capabilities for J-Link debuggers, enabling memory, flash, register, and RTT operations through AI assistants.
      42
      MIT