MCP Remote Access

   

通过MCP对嵌入式设备进行SSH和串行端口控制——登录Raspberry Pi，与UART通信，从助手驱动USB-C控制台。 从IDE、终端或AI代理中驱动它，让模型为您运行实验室工作台。

快速开始 · 工具 · 工作流 · 文档

______________________________________________________________________

什么是mcp远程访问？

mcp-remote-access 是一个公开SSH（通过paramiko）的MCP服务器 以及串行/UART（通过pyserial）作为MCP工具。这是“给予 代理根在板凳上“MCP-一旦它运行，你的助手可以 登录Pi，运行命令，传输文件，打开串行控制台， 通过DTR/RTS发送AT风格的命令序列并重置设备。

它刻意精简：24个工具，两个传输，没有编排 语言。更高级别的工作流逻辑存在于代理的提示中。

它擅长什么：

• 🤖 通过MCP实现AI原生。 头等舱 模型上下文协议

服务器与 24工具 通过SSH和UART。

• 🐍 嵌入式友好。 通过以下方式连接到串行端口 **VID / PID

序列/描述** 比赛——别再猜了 /dev/ttyUSB0 vs /dev/ttyUSB1.

• ⏳ 后台SSH命令。 长时间运行的命令(make,

pytest, tcpdump)通过运行异步 ssh_execute_background；投票 随着 ssh_check_background.

• 🤝 提示感知UART。 serial_expect 和 serial_wait_for

处理登录提示、AT风格的流程和引导加载程序握手 没有种族条件。

• 🔌 DTR/RTS控制。 通过USB串行硬复位MCU，发送

断开信号，将启动引脚保持在低位——这是常见的嵌入式技巧。

• 🔒 AGPL-3.0或更高版本。 仅内存凭据，没有磁盘会话存储。

______________________________________________________________________

快速开始

安装

git clone https://github.com/RFingAdam/mcp-remote-access.git
cd mcp-remote-access
uv pip install -e .

两个表面，相同的答案

命令行界面

直接运行MCP服务器（stdio）：

uv run --directory /path/to/mcp-remote-access \
  mcp-remote-access

添加到MCP客户端

Codex CLI：

codex mcp add remote-access -- \
  uv run --directory /path/to/mcp-remote-access mcp-remote-access

克劳德代码：

claude mcp add remote-access -- \
  uv run --directory /path/to/mcp-remote-access mcp-remote-access

MCP（克劳德桌面、克劳德代码、Codex CLI、任何MCP客户端）

添加到客户端的配置文件中：

{
  "mcpServers": {
    "remote-access": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-remote-access", "mcp-remote-access"]
    }
  }
}

然后问你的助手：

*“以vpn-ap.local连接到我的Pi pi （密码 raspberry)，跑 uname -a那么 dmesg | tail -20."*

代理人打电话来 ssh_connect, ssh_execute 两次，并同时报告 以纯文本形式输出。

______________________________________________________________________

工具

两次运输中有24个MCP工具。完整参考 docs/tools.md.

SSH（9）

串行/UART（15）

______________________________________________________________________

工作流

mcp-remote-access 符合以下条件 eng-mcp套房 工作流捆绑包：

• lab-automation --搭配 mcp-rs-spectrum-analyzer,

mcp-rs-siggen, copper-mountain-vna-mcp 完整地编写a 工作台（DUT通过SSH或UART登录，实验室设备通过SCPI）。

• embedded-bringup — serial_connect_match + serial_expect +

ssh_upload 用于引导加载程序交互和图像闪烁。

部分 eng-mcp套房. 使用在 lab-automation 工作流包。

看 套房清单 查看兄弟MCP和捆绑包定义的完整列表。

______________________________________________________________________

文档

• 📘 快速开始 --通过第一次调用进行安装。
• 🛠️ 工具参考 --每一个MCP工具，每一个论点。
• 📐 使用示例 --实用的端到端演练。
• 🏗️ 建筑 --这个MCP如何适应eng-MCP套件。

______________________________________________________________________

eng-mcp套件的一部分

此MCP服务器是


为跨RF、EMC、PCB的MCP服务器工程提供开放式保护伞， 信号完整性、EM仿真和实验室测试。同一品牌，同一文件 结构，旨在组成。看 完整目录 或者跳到兄弟姐妹：

______________________________________________________________________

安全说明

• 保留SSH密码 仅在内存中 并在服务器上清除

重新启动。

• 连接是会话范围的；服务器没有持久化

会话存储在磁盘上。

• 尽可能使用SSH密钥。
• MCP服务器在stdio上运行，它只接受来自

本地MCP客户端，从不来自网络。

______________________________________________________________________

故障排除

SSH连接问题 --验证主机是否可访问 (ping vpn-ap.local)，SSH正在侦听目标 (ssh pi@vpn-ap.local 来自同一shell），并且凭据是 对的。

串行端口问题 --检查端口权限 (ls -la /dev/ttyUSB*)，将您的用户添加到 dialout 群组 (sudo usermod -a -G dialout $USER 并重新登录），并确认 设备存在(dmesg | tail).

VID/PID匹配选择了错误的设备 — serial_connect_match 回报 第一次打击；搭配这场比赛 description 或 serial_number 到 消歧义。

______________________________________________________________________

贡献

欢迎捐款。

1. 选择一个 .
2. 分叉+分支 (feature/your-thing 或 fix/your-bug).
3. 运行测试 (uv run pytest)如果存在。
4. 打开PR --链接问题，请求审核。

______________________________________________________________________

许可证

AGPL-3.0或更高版本.从v0.2.0中的Apache-2.0到 与eng-mcp套件工具包范围内的AGPL移动保持一致。

致谢

• 参数 --SSH传输。
• pyserial --串行/UART传输。
• MCP工作组 --对于 模型上下文协议 规范。

部分 eng-mcp套房 --专为RF工程师、PCB设计师、EMC实验室和AI代理而构建。