How do I use embedded-mcp-toolkit?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@embedded-mcp-toolkit scan for available COM ports" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

embedded-mcp-toolkit

by smk-h

Overview Schema Related Servers Score Discussions

TypeScript

Local

一、简介

1. 是什么？

embedded-mcp-toolkit 是一个基于 MCP（Model Context Protocol）协议的嵌入式板卡远程管理工具，通过多个 MCP 工具提供嵌入式设备交互能力。支持以下功能：

串口管理：打开/关闭串口连接、发送命令、读取输出、一键登录（自动检测 PSH 并解锁）、进入 U-Boot 命令行
SSH 管理：打开/关闭 SSH 会话、发送命令、读取输出、一键登录（自动检测 PSH 并解锁）、查看远端设备活跃连接
本地 PowerShell：打开/关闭本地 PowerShell 会话、发送命令、读取输出，方便在对话中直接操作 Windows 环境
Windows 系统扫描：扫描可用 COM/LPT 端口、扫描本机网络适配器与 IP 配置
基础信息：查询 MCP 服务器版本、获取当前设备配置信息
多会话管理：同时保持多个串口、SSH、PowerShell 会话，支持独立读写
KeyProvider 密钥管理：支持文件 IPC 和终端交互两种方式，自动处理 PSH 动态口令生成的密钥
进程退出自动清理：客户端断开或进程终止时自动释放所有串口、SSH、PowerShell 连接

2. 架构关系

OpenCode、MCP Client 与 MCP Server 的三层关系如下：

┌─────────────────────────────────────────────┐
│  OpenCode (MCP Host)                        │
│  ┌────────────┐  ┌────────────┐             │
│  │ MCP Client │  │ MCP Client │  ...        │
│  │ (stdio)    │  │ (http)     │             │
│  └─────┬──────┘  └─────┬──────┘             │
└────────┼───────────────┼────────────────────┘
         │               │
    stdin/stdout      HTTP/SSE
         │               │
┌────────┴────────┐   ┌──┴───────────┐
│ MCP Server A    │   │ MCP Server B │
│ (embedded-mcp-  │   │ (其他服务)    │
│  toolkit)       │   │              │
└─────────────────┘   └──────────────┘

角色	说明	在本项目中的体现
MCP Host	AI 应用，管理多个 Client，把 tool result 喂给 LLM	OpenCode / Claude Code
MCP Client	Host 内部组件，与 Server 保持 1:1 连接，通过 JSON-RPC 通信	Host 每配置一个 Server 就创建一个 Client
MCP Server	提供 tools 供 Agent 调用的独立进程	`embedded-mcp-toolkit`

通信流程：OpenCode 读取配置 → 创建 MCP Client → 以 stdio 启动 MCP Server 子进程 → 双方通过 JSON-RPC 通信。Agent 说"调用 xx 工具"时，Host 通过 Client 向 Server 发 tools/call，结果返回给 LLM。

注意：Server 发送的推送通知（如 notifications/message）由 Client 接收后止于 Host，不会转发给 Agent。因此需要 Agent 感知的事件应通过 tool 返回值（pull 模式）传递，详见开发计划 2。

3. 怎么安装

2.1 npm

目前支持工具的全局安装和本地指定目录安装，但是全局安装后还是只能在某个目录配置使用（需要claude配置文件、设备配置文件、mcp配置文件以及日志等），暂未测试过全局配置。

mkdir mcp-toolkit
cd mcp-toolkit

# 当前目录安装
npm i @smai-kit/embedded-mcp-toolkit

# 初始化
./node_modules/.bin/embedded-mcp-toolkit init

安装配置完成后目录结构如下：

mcp-toolkit
├── .claude                      # claude配置目录   
│   ├── CLAUDE.md
│   ├── settings.local.json      # 项目配置文件，不用管
│   ├── skills                   # claude skills,只是写了一些技能，实际可能不需要
│   ├── start-claude.bat.tmp     # 以指定环境变量启动claude的bat脚本
│   └── start-claude.ps1.tmp     # 以指定环境变量启动claude的powershell脚本
├── .mcp.json                    # claude code的mcp配置文件
├── .opencode                    # opencode的配置目录，暂时不用管
│   └── opencode.json
├── configs                      # 配置目录
│   ├── challenge.txt            # 登录psh时的挑战码（动态口令）
│   ├── config.example.yaml      # 配置模板文件
│   ├── config.yaml              # 复制上面的模板文件，进行板子的添加和修改
│   └── password_input.txt       # 密钥文件，通过挑战码生成
├── log                          # 日志目录，当前claude启动时会自动创建，写入一些工具调用日志
│   ├── 2026-05-27_09-06-09.log
├── node_modules                 # node依赖包目录，可以不用管
│   ├── .bin
│   ├── .package-lock.json
│   ├── @smai-kit                # @smai-kit/embedded-mcp-toolkit中是编译后的js脚本
│   ├── #...
│   └── zod
├── package-lock.json
└── package.json                 # npm项目包依赖管理文件，不用管

2.2 源码安装

git clone源码后：

npm i         # 安装依赖
npm run build # 编译，编译后就可以在当前目录下启动claude使用了

4. 工具介绍

4.1 基础工具

工具名称	功能说明	常用提示词
`greet_tool`	测试工具，按名称问候	`给苏木打个招呼`
`version_tool`	获取 MCP 服务器版本和工具包信息	`当前MCP版本是什么`
`device_info_tool`	获取当前设备配置（SSH、串口、KeyProvider）	`当前设备信息是什么` / `列出默认的设备`

4.2 串口工具

工具名称	功能说明	常用提示词
`serial_open`	打开串口连接，启动交互式 shell 会话	`打开串口` / `连接 COM3`
`serial_close`	关闭串口会话，释放端口资源	`关闭串口` / `退出串口 serial_1`
`serial_write`	向串口会话发送命令	`向串口发送命令` / `在串口执行 whoami`
`serial_read`	读取串口会话的输出数据	`读取串口输出` / `看看串口返回了什么`
`serial_list`	列出所有活跃的串口会话	`列出串口会话` / `当前有哪些串口连接`
`serial_exec`	向串口发送命令并等待输出（write + delay + read）	`在串口执行 uname -a` / `让串口运行命令 xxx`
`serial_shell_login`	一键串口登录，自动检测 PSH 状态并解锁	`串口一键登录` / `串口登录 board-test`
`serial_enter_uboot`	重启设备并进入 U-Boot 命令行	`重启进入 uboot` / `进入 U-Boot 命令行`

4.3 SSH 工具

工具名称	功能说明	常用提示词
`ssh_shell_open`	打开交互式 SSH shell 会话	`打开 SSH` / `SSH 连接 board-test`
`ssh_shell_close`	关闭 SSH shell 会话，释放连接	`关闭 SSH` / `退出 ssh_1`
`ssh_shell_write`	向 SSH 会话发送命令	`SSH 发送命令` / `在 ssh 里执行 ls`
`ssh_shell_read`	读取 SSH 会话的输出数据	`读取 SSH 输出` / `SSH 返回了什么`
`ssh_shell_list`	列出所有活跃的 SSH 会话	`列出 SSH 会话` / `当前有哪些 SSH 连接`
`ssh_shell_exec`	向 SSH 发送命令并等待输出（write + delay + read）	`SSH 执行 ifconfig` / `在 SSH 运行命令 xxx`
`ssh_shell_connection`	检查远端板卡上活跃的 SSH 连接	`查看设备上的 SSH 连接` / `谁连到了这台设备`
`ssh_shell_login`	一键 SSH 登录，自动检测 PSH 状态并解锁	`SSH 一键登录` / `SSH 登录 board-test`

4.4 Windows 工具

工具名称	功能说明	常用提示词
`port_scan_tool`	扫描 Windows 设备管理器中的 COM / LPT 端口	`扫描可用串口` / `查看有哪些 COM 口`
`network_scan_tool`	扫描 Windows 网络适配器和 IP 配置	`扫描网络适配器` / `查看本机网卡信息`
`power_shell_open`	打开本地 PowerShell 交互式会话	`打开 PowerShell` / `启动本地 PowerShell`
`power_shell_close`	关闭 PowerShell 会话并终止进程	`关闭 PowerShell` / `退出 power_1`
`power_shell_write`	向 PowerShell 会话发送命令	`PowerShell 执行命令` / `执行 ps 命令 xxx`
`power_shell_read`	读取 PowerShell 会话的输出数据	`读取 PowerShell 输出` / `PowerShell 返回了什么`
`power_shell_list`	列出所有活跃的 PowerShell 会话	`列出 PowerShell 会话` / `当前有哪些 ps 会话`
`power_shell_exec`	向 PowerShell 发送命令并等待输出（write + delay + read）	`PowerShell 执行 ipconfig` / `用 ps 运行 xxx`

Related MCP server: interminal

二、配置说明

1. claude配置

目前还未测试过全局配置，后续测试验证。当前配置下，只测试过在指定项目目录使用。

1.1 `.claude/settings.local.json`

{
  "permissions": {
    "allow": [
      "mcp__embedded-board__device_info_tool",
      "mcp__embedded-board__ssh_shell_login",
      "mcp__embedded-board__ssh_shell_connection",
      "mcp__embedded-board__ssh_shell_close",
      "mcp__embedded-board__serial_shell_login",
      "mcp__embedded-board__serial_close",
      "mcp__embedded-board__serial_exec",
      "mcp__embedded-board__version_tool",
      "mcp__embedded-board__ssh_shell_exec",
      "mcp__embedded-board__serial_list",
      "mcp__embedded-board__serial_read",
      "mcp__embedded-board__ssh_shell_list"
    ]
  },
  "enabledMcpjsonServers": [
    "embedded-board"
  ]
}

permissions：允许claude自动执行而不需要用户确认，这个其实不用管，在claude code运行时会提醒 Yes, and don’t ask again for: xxxx，选择这个就会自动添加到这里，下一次再运行就不需要再确认。
enabledMcpjsonServers：启用的 MCP 服务器列表。当前仅启用 embedded-board。

1.2 `.mcp.json`

此文件和.claude同级，文件内容如下（npm本地安装）：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "mcpServers": {
    "embedded-board": {
      "command": "./node_modules/.bin/embedded-mcp-toolkit",
      "args": [],
      "env": {
        "DEVICE": "board-b",
        "BOARD_CONFIG_PATH": "./configs/config.yaml",
        "LOG_SAVE": "1",
        "LOG_DIR": "./log"
      }
    }
  }
}

这个是MCP的配置文件。env 字段中定义的环境变量会在 Claude 启动 MCP server 时，注入到 MCP server 子进程 的 process.env 中。也就是说，这些变量只在 src/mcp.ts 进程中通过 process.env.DEVICE 等方式读取，不会影响 Claude 自身的 shell 环境变量。

DEVICE：默认的设备名称，对应 config.yaml 中 devices 下的 key
BOARD_CONFIG_PATH：主配置文件 config.yaml 的路径，相对于 MCP server 进程的工作目录（即启动 Claude 时的 cwd）。注意：devices/ 目录的查找位置始终是 config.yaml 的同级目录，因此 BOARD_CONFIG_PATH 同时决定了 config.yaml 和 devices/ 的位置
LOG_SAVE：是否存储日志到文件（"1" 表示开启），会记录工具调用信息，例如工具名称、调用时传入的参数
LOG_DIR：日志存储的目录，同样相对于 MCP server 进程的工作目录

Tips：MCP server 进程的工作目录就是启动 Claude（或其他 MCP 客户端）时所在的目录。可以在日志文件的第一行看到 cwd: xxx 来确认实际的工作目录。
环境变量不生效？看一下这里：常见问题 2. 环境变量未生效？

2. 日志信息

这个是在.mcp.json中配置的，得到的日志信息可能如下：

[2026-05-27 18:55:39] [INFO] MCP server starting... cwd: E:\AI\embedded-mcp-toolkit
[2026-05-27 18:55:39] [INFO] MCP server env: {"DEVICE":"board-b","BOARD_CONFIG_PATH":"./configs/config.yaml","LOG_SAVE":"1","LOG_DIR":"./log"}
[2026-05-27 18:56:20] [INFO] [greet_tool] name=苏木
[2026-05-27 18:56:27] [INFO] [version_tool]
[2026-05-27 18:56:38] [INFO] [device_info_tool] device=(default)
[2026-05-27 18:56:38] [INFO] Config loaded: E:\AI\embedded-mcp-toolkit\configs\config.yaml
[2026-05-27 18:56:38] [INFO] Device resolved: board-b
[2026-05-27 18:56:38] [INFO] [KeyProvider/ssh] challenge file: E:\AI\embedded-mcp-toolkit\configs\challenge.txt
[2026-05-27 18:56:38] [INFO] [KeyProvider/ssh] key file:       E:\AI\embedded-mcp-toolkit\configs\password_input.txt
[2026-05-27 18:56:38] [INFO] [KeyProvider/serial] challenge file: E:\AI\embedded-mcp-toolkit\configs\challenge.txt
[2026-05-27 18:56:38] [INFO] [KeyProvider/serial] key file:       E:\AI\embedded-mcp-toolkit\configs\password_input.txt
[2026-05-27 18:57:13] [INFO] [serial_open] device=(default) port=(auto) baudRate=115200
[2026-05-27 18:57:13] [INFO] Device resolved: board-b
[2026-05-27 18:57:13] [INFO] [serial_open] session opened: serial_1 port=COM3
[2026-05-27 18:57:36] [INFO] [serial_close] session_id=serial_1
[2026-05-27 18:57:55] [INFO] [serial_shell_login] device=(default) timeout=1500 key=(none)
[2026-05-27 18:57:55] [INFO] Device resolved: board-b
[2026-05-27 18:57:57] [INFO] [serial_shell_login] session opened: serial_2 port=COM3
[2026-05-27 18:58:13] [INFO] [serial_exec] session_id=serial_2 command=exit delay=1000 clear=1
[2026-05-27 18:58:27] [INFO] [serial_shell_login] device=(default) timeout=1500 key=(none)
[2026-05-27 18:58:27] [INFO] Device resolved: board-b
[2026-05-27 18:58:30] [INFO] Device resolved: board-b
[2026-05-27 18:58:30] [INFO] [KeyProvider/serial] challenge file: E:\AI\embedded-mcp-toolkit\configs\challenge.txt
[2026-05-27 18:58:30] [INFO] [KeyProvider/serial] key file:       E:\AI\embedded-mcp-toolkit\configs\password_input.txt
[2026-05-27 18:58:38] [INFO] [serial_shell_login] session reused: serial_2 port=COM3
[2026-05-27 18:58:54] [INFO] [serial_enter_uboot] session_id=serial_2 timeout=60s
[2026-05-27 18:59:11] [INFO] [serial_enter_uboot] detected any-key autoboot prompt
[2026-05-27 18:59:36] [INFO] [serial_exec] session_id=serial_2 command=help delay=3000 clear=1

会记录工具的名称、传入的参数等。

3. `configs`配置

设备配置支持两种布局，二选一即可（兼容老配置）：

布局	适用场景	设备配置放在
单文件布局（老方式）	设备少（1~2 台）	全部写在 `config.yaml` 的 `devices` 段里
分文件布局（新方式，推荐）	设备多	每台设备一个文件，放在 `devices/` 目录下

两种布局同时存在时（devices/ 目录非空 + config.yaml 还有 devices 段）：以 devices/ 目录为准，config.yaml 里的 devices 段被忽略。 此时修改设备请改 devices/<设备名>.yaml，改 config.yaml 的 devices 段无效。default 等全局字段始终从 config.yaml 读取。

3.1 方式一：单文件布局（老方式）

所有设备写在 config.yaml 的 devices 段里，无需 devices/ 目录：

# config.yaml
default: board-b

devices:
  board-a:
    ssh:
      host: "192.168.16.103"
      port: 22
      username: "root"
      password: "root"
    serial:
      port: "COM4"
      baudRate: 115200
  board-b:
    ssh:
      host: "192.168.16.105"
      port: 22
      username: "root"
      password: "root"
    serial:
      port: "COM3"
      baudRate: 115200

3.2 方式二：分文件布局（新方式，推荐）

config.yaml 只放 default 等全局设置，每台设备一个独立文件：

.embedded/configs/
├── config.yaml              # 仅放 default 等全局设置
└── devices/
    ├── board-a.yaml         # 每台设备一个文件，文件名即设备名
    └── board-b.yaml

config.yaml（仅全局设置）：

# config.yaml
default: board-b

devices/board-a.yaml（单台设备的完整、自包含配置）：

adb:
  serialNo: "sn_none"
ssh:
  host: "192.168.16.103"
  port: 22
  username: "root"
  password: "root"
serial:
  port: "COM4"
  baudRate: 115200

新增设备只需在 devices/ 下复制一个 .yaml 文件并修改，无需改动 config.yaml。

从老方式迁移：运行 embedded-mcp-toolkit split，自动把 config.yaml 的 devices 段拆分为 devices/*.yaml（详见 3.3 配置拆分命令）。

3.3 配置拆分命令（split）

split 命令用于把单文件布局的 config.yaml 迁移为分文件布局。它读取 config.yaml 的 devices 段，为每个设备生成一个独立的 devices/<设备名>.yaml 文件。

【基本用法】

# 使用默认源路径 ./.embedded/configs/config.yaml
embedded-mcp-toolkit split

# 指定源 config.yaml 路径
embedded-mcp-toolkit split --config ./path/to/config.yaml

# 强制覆盖已存在的设备文件（默认跳过已存在）
embedded-mcp-toolkit split --force

【选项】

选项	说明	默认值
`-c, --config <path>`	源 `config.yaml` 路径	`./.embedded/configs/config.yaml`
`-f, --force`	覆盖已存在的设备文件	`false`（默认跳过已存在）

【输出示例】

✂️  embedded-mcp-toolkit 配置拆分
   源配置: ./.embedded/configs/config.yaml
   设备目录: ./.embedded/configs/devices
   覆盖模式: 跳过已存在

  ✅ 创建: board-a
  ✅ 创建: board-b
  ⏭  跳过（已存在）: board-c

✅ 拆分完成：创建 2，覆盖 0，跳过 1

【说明】

拆分后建议手动清理 config.yaml 中的 devices 段（保留 default 等全局字段），避免两份配置并存造成混淆。devices/ 目录存在时，加载层只看 devices/*.yaml，config.yaml 的 devices 段不生效。
拆分是非破坏性的：原 config.yaml 不会被修改或删除，只是多出 devices/*.yaml 文件。
同一设备文件已存在时默认跳过，加 --force 才覆盖。

3.4 常用字段说明

无论哪种布局，单台设备的字段含义相同，一般只需修改下面几个：

ssh:
  host: "xxx.xxx.xxx.xxx" # 设备 IP 地址
  port: 22
  username: "root"        # 设备的用户名
  password: "root"        # 设备用户的登录密码
serial:
  port: "COM3"            # 串口的端号
  baudRate: 115200        # 波特率

【通道启用/禁用约定】

通道	禁用取值	说明
SSH	`ssh.host: "none"`	该设备不启用 SSH（调用 ssh 工具返回 "does not support SSH"）
串口	`serial.port: "none"`	该设备不启用串口（调用 serial 工具返回 "does not support serial"）
ADB	`adb.serialNo: "sn_none"` 或留空	不绑定具体设备，由 adb 自动发现

不需要的通道可直接整段删除。

关于 keyProvider：用于具有 PSH 的设备在解锁时提供密钥，支持 file（文件读写）和 terminal（终端输入）两种模式。Claude Code 自动调用工具登录的场景下推荐 file 模式。其 challengeFilePath / keyFilePath 是**相对运行 MCP server 时的工作目录（cwd）**的路径，通常写 ./ 开头的项目相对路径即可（与 config.yaml 或设备文件的位置无关）。

3.5 两个 txt 文本文件

.embedded/configs/challenge.txt
.embedded/configs/password_input.txt

challenge.txt 存放动态口令，一键登录时自动读取串口或 SSH 的动态口令并写入此文件
password_input.txt 存放密钥，用动态口令生成密钥后写入此文件

Tips：当密钥被读走后，这两个文件都会被清空。

三、简单示例

1. 启动 claude

cd mcp-toolkit
claude

然后可以在claude中执行 /mcp list来查看mcp服务是否连接：

╭─── Claude Code v2.1.152 ─────────────────────────────────────────────────────────────╮
│                                   │ Tips for getting started                         │
│           Welcome back!           │ Run /init to create a CLAUDE.md file with instr… │
│                                   │ ──────────────────────────────────────────────── │
│              ▐▛███▜▌              │ What's new                                       │
│             ▝▜█████▛▘             │ `/code-review --fix` now applies review finding… │
│               ▘▘ ▝▝               │ Skills and slash commands can now set `disallow… │
│                                   │ Added `/reload-skills` command to re-scan skill… │
│   Lanz-Auto · API Usage Billing   │ /release-notes for more                          │
│            D:\Temp\aaa            │                                                  │
╰──────────────────────────────────────────────────────────────────────────────────────╯


❯ /mcp list

────────────────────────────────────────────────────────────────────────────────────────
  Manage MCP servers
  1 server

    Project MCPs (D:\Temp\aaa\.mcp.json)
  ❯ embedded-board · ✔ connected · 18 tools

  https://code.claude.com/docs/en/mcp for help
 ↑/↓ to navigate · Enter to confirm · Esc to cancel

connected前面✔就表示mcp连接成功。

2. 常用提示词

# 获取当前设备信息
❯ 当前设备信息是什么

# 登录设备，没有xxx的话是会用默认设备
❯ ssh一键登录xxx设备
❯ 串口一键登录xxx设备

# 退出登录
❯ 退出xxx设备登录
❯ 关闭ssh_id
❯ 关闭串口serial_id
❯ 关闭所有会话

四、常见问题

1. 串口被拒绝（Port busy / Access denied）

Windows 下串口（COM 口）是独占资源，同一时间只能有一个进程打开。如果 MCP server 尝试打开串口时提示 Port is open、Access denied 或 Permission denied，说明该 COM 口已被其他程序占用。

1.1 常见占用场景

其他串口调试工具未关闭（如 SecureCRT、PuTTY、MobaXterm、Xshell、minicom 等）
资源管理器窗口打开着该串口（某些驱动会在资源管理器中锁定）
上一个 MCP server 实例未正常退出，残留进程仍持有串口句柄
虚拟机软件（VMware、VirtualBox）占用了宿主机串口做直通映射

1.2 排查方法

（1）关闭所有可能占用串口的工具，然后重试。

（2）Windows 任务管理器检查是否有残留的 node.exe 进程，如果有则结束掉。

（3）使用 PowerShell 查看串口占用（需要管理员权限）：

# 查看当前系统可用串口
[System.IO.Ports.SerialPort]::GetPortNames()

# 查看串口设备详细信息
Get-WMIObject Win32_SerialPort | Select-Object Name, Description, DeviceID

（4）在设备管理器（devmgmt.msc）中确认 COM 口编号未变化（USB 转串口设备重新插拔后编号可能改变）。

1.3 解决方法

关闭占用程序后重试
如果是在 Claude 中，先执行"关闭所有会话"确保释放串口，再重新登录
重新插拔 USB 转串口设备，确认 COM 口编号后在设备配置中更新 serial.port 字段

2. 环境变量未生效？

如果启动后日志中没有看到 env 信息，或者工具运行时读取不到这些变量，可以从以下几个方面排查：

（1）Claude Code 版本过低：也可能是个原因吧，我使用的是 2.1.152 版本。更新命令：

npm list -g @anthropic-ai/claude-code              # 查看当前系统安装的node包的版本
npm view @anthropic-ai/claude-code versions --json # 查看 npm 服务器上发布的所有版本
npm i -g @anthropic-ai/claude-code                 # 全局安装

（2）.mcp.json 文件路径不正确：该文件必须放在 Claude 启动时的项目根目录下（与 .claude/ 目录同级）。如果放错了位置，Claude 不会读取它。

（3）enabledMcpjsonServers 未配置：需要在 .claude/settings.local.json 中配置 "enabledMcpjsonServers": ["embedded-board"]，否则 Claude 不会启动对应的 MCP server。

（4）修改 .mcp.json 后未重启 Claude：.mcp.json 只在 Claude 启动时读取一次。修改后需要完全退出 Claude 再重新启动，新的环境变量才会生效。

（5）JSON 格式错误：.mcp.json 中缺少逗号、引号不匹配等语法错误会导致整个文件解析失败，Claude 可能静默忽略该配置。

（6）command 路径错误：如果 command 指定的脚本路径不存在（如未执行 npm install 导致 ./node_modules/.bin/embedded-mcp-toolkit 不存在），MCP server 无法启动，环境变量自然也无法被读取。

（7）相对路径的工作目录问题：BOARD_CONFIG_PATH 和 LOG_DIR 使用的是相对路径，它们是相对于 MCP server 进程的 cwd（即启动 Claude 时所在的目录）解析的。如果不是从项目根目录启动 Claude，这些相对路径可能指向错误的位置。

3. 其他问题

......

五、开发计划

1. Shell 会话持续监听与错误扫描

1.1 目标

改造 shell 会话（adb/ssh/serial/powershell）的数据采集机制，从"按需收集"升级为"持续监听 + 并行扫描"，使 AI 能在任意时间点获取完整会话输出及已识别的错误告警。

1.2 架构设计

stdout/stderr.on("data") ──→ appendBuffer(data)
                               ├── 存入 #buffer（等待 read() 拉取）
                               └── 即时扫描错误模式 → 命中则记入 #alerts 列表

【两路并行】

通路	功能	触发方式
数据存储	持续写入 `#buffer`，不再丢弃	data 事件自动触发
模式识别	扫描 error pattern，写入 `#alerts`	data 事件自动触发

【与现有行为对比】

现有：#collecting 仅在 write() 到 read() 之间开启，其余时间数据丢弃
改造后：open() 起 #collecting 始终为 true，所有输出持续归档

1.3 TODO 任务清单

#	状态	任务	涉及文件	优先级
1	⬜	去掉 `#collecting = false` 关闭点	`src/transport/adb.ts`	高
		`open()` 中 banner 收集后不再关闭 `#collecting`；`read(clear=1)` 中保留 `#buffer = ""` 但不关闭 `#collecting`
2	⬜	新增 `#alerts` 告警队列与 Alert 类型定义	`src/transport/adb.ts`	高
		定义 `Alert { pattern, timestamp, detail }` 结构；新增 `#alerts: Alert[]` 成员
3	⬜	实现 `#scanAlerts(data)` 错误模式扫描器	`src/transport/adb.ts`	高
		预定义嵌入式常见错误正则库（kernel panic、OOM、segfault、watchdog timeout 等）；在 `appendBuffer` 入口调用 `#scanAlerts(data)`
4	⬜	增强 `read()` 返回值结构	`src/transport/adb.ts`	中
		`read()` 返回 `{ data, alerts: [{ pattern, timestamp, detail }] }`；如有未读告警一并返回并清空 `#alerts`
5	⬜	增强 `exec()` 返回值，附带 alerts	`src/mcp/tools/adb/shell.ts`	中
		`exec()` 内部调用 `read()` 后，将 alerts 一并封装进 MCP 响应内容
6	⬜	适配 SSH transport	`src/transport/ssh.ts`	中
		对 ssh.ts 做与 adb.ts 相同的改造（持续 buffer + 错误扫描 + alerts）
7	⬜	适配 Serial transport	`src/transport/serial.ts`	中
		对 serial.ts 做相同改造
8	⬜	适配 PowerShell transport	`src/transport/powershell.ts`	低
		对 powershell.ts 做相同改造
9	⬜	抽取公共基类/混入，消除重复代码	`src/transport/`	低
		四个 transport 类存在大量重复的 buffer/collecting 逻辑，改造完成后考虑抽取 `BaseTransport` 抽象类

1.4 错误模式库

模式名	正则 / 关键字	场景
`kernel_panic`	`Kernel panic`	内核崩溃
`oom`	`Out of memory` / `OOM killer`	内存耗尽
`segfault`	`Segmentation fault`	段错误
`watchdog_timeout`	`watchdog.*timeout`	看门狗超时
`bus_error`	`Bus error`	总线错误
`gpio_error`	`gpio.*error`	GPIO 异常
`i2c_error`	`i2c.*error`	I2C 通信异常
`spi_error`	`spi.*error`	SPI 通信异常
`uart_error`	`uart.error` / `serial.error`	串口异常
`mount_error`	`mount.*fail`	挂载失败
`network_down`	`link down` / `network unreachable`	网络断开
`nand_error`	`nand.*(error\|fail)`	NAND 闪存异常
`emmc_error`	`mmc.error` / `mmcblk.error`	eMMC 异常

1.5 预期效果

AI 调用 exec("dmesg") 后，返回值中自动附带 alerts: [{ pattern: "oom", detail: "..." }]，无需 AI 自行解析长文本
后台持续采集不丢数据，即使 AI 间隔较长时间才调用下一次 read()
告警在 stdout 到达瞬间即被识别，不依赖 AI 轮询频率

2. Agent 消息拉取通知

2.1 目标

MCP 协议的服务端推送通知（notifications/message）由 host 拦截，无法直接到达 Agent（LLM）。改为 pull 模式：服务端维护事件消息队列，Agent 通过工具主动拉取，实现 Agent 可感知的异步通知。

2.2 架构设计

会话事件（断开/超时/异常） ──→ messageQueue.push(event)
                                    ↓
Agent 调用 fetch_notifications_tool ──→ 取出并清空 messageQueue → 返回给 Agent

【与 push 通知对比】

	push 通知	pull 拉取
方向	服务端→host	Agent→服务端（请求-响应）
Agent 可见	否（host 拦截）	是（作为 tool result 返回）
实现依赖	需 host 适配	标准 MCP tool 即可

2.3 TODO 任务清单

#	状态	任务	涉及文件	优先级
1	⬜	定义消息队列与事件类型	`src/infra/`	高
		定义 `EventMessage { type, timestamp, detail }` 结构；实现 `MessageQueue` 类（push / drain）
2	⬜	新增 `fetch_notifications_tool` 拉取工具	`src/mcp/tools/basic/`	高
		Agent 调用后返回消息队列中的全部事件并清空；无事件时返回提示信息
3	⬜	会话异常断开时自动写入消息队列	`src/mcp/tools/{ssh,serial,adb,win}/`	中
		SSH/串口/ADB/PowerShell 会话因网络中断、超时、进程退出等原因断开时，自动将事件入队
4	⬜	客户端断开时推送告警	`src/mcp/server.ts`	低
		stdin close 回调中，将"client disconnected"事件写入消息队列（需注意此时可能已无法响应工具调用）

2.4 预期效果

Agent 在每次操作前/后调用 fetch_notifications_tool 检查是否有异步事件，无需持续轮询
会话断开等异常不再"静默丢失"，Agent 能在下一轮对话中获知
不依赖 host 的特殊适配，标准 MCP tool 即可工作

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/smk-h/embedded-mcp-toolkit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server