MCP Remote Access

🚀 SSH與串口遠程訪問服務

本項目是一個MCP服務器，為兼容MCP的客戶端（如Codex CLI或Claude Code）提供SSH和UART/串口訪問功能。藉助該項目，你可以直接控制樹莓派、嵌入式系統和物聯網設備等遠程設備。

🚀 快速開始

本項目為兼容MCP的客戶端提供SSH和串口訪問功能，可直接控制遠程設備。以下是使用步驟：

1. 克隆並安裝項目
2. 將其添加到你的MCP客戶端
3. 啟動客戶端

✨ 主要特性

SSH工具

• ssh_connect - 通過SSH（密碼或密鑰認證）連接到遠程主機
• ssh_execute - 在已連接的主機上運行命令
• ssh_upload - 通過SFTP上傳文件
• ssh_download - 通過SFTP下載文件
• ssh_disconnect - 關閉連接
• ssh_list_connections - 顯示活動連接

UART/串口工具

• serial_list_ports - 列出可用的串口
• serial_connect - 連接到串口
• serial_connect_match - 通過匹配VID/PID/序列號/描述信息來連接
• serial_send - 發送數據（可選擇讀取響應並配置行尾符）
• serial_read - 從端口讀取數據
• serial_wait_for - 等待輸出中出現特定模式
• serial_expect - 等待/發送序列以處理提示和AT流程
• serial_send_break - 發送中斷信號
• serial_set_dtr - 設置DTR線路狀態
• serial_set_rts - 設置RTS線路狀態
• serial_reset_device - 通過DTR/RTS序列重置設備
• serial_flush - 刷新串口緩衝區
• serial_disconnect - 關閉連接
• serial_list_connections - 顯示活動連接

📦 安裝指南

1. 克隆並安裝

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

2. 添加到你的MCP客戶端

Codex CLI示例

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

Claude Code示例

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

如果你的客戶端使用配置文件，請將MCP服務器命令設置為：

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

3. 啟動你的客戶端

例如：

codex

claude

💻 使用示例

基礎用法

SSH連接到樹莓派

使用用戶名 pi 和密碼 raspberry 連接到位於 vpn-ap.local 的樹莓派

客戶端將使用以下步驟：

1. 使用 ssh_connect 建立連接
2. 使用 ssh_execute 運行命令
3. 使用 ssh_upload/download 進行文件傳輸

串口連接到嵌入式設備

列出可用的串口並以115200波特率連接到 /dev/ttyUSB0

客戶端將使用以下步驟：

1. 使用 serial_list_ports 顯示可用端口
2. 使用 serial_connect 建立連接
3. 使用 serial_send / serial_read 進行通信

以115200波特率連接到VID為0x10c4、PID為0xea60的USB串口設備

客戶端將使用以下步驟：

1. 使用 serial_connect_match 選擇端口
2. 使用 serial_send / serial_read 進行通信

串口提示自動化

連接到UART並以root用戶（密碼為summit）登錄，然後等待shell提示

客戶端將使用以下步驟：

1. 使用 serial_connect 或 serial_connect_match 打開端口
2. 使用 serial_expect 等待提示併發送響應

🔧 技術細節

安全注意事項

• SSH密碼僅在內存中傳遞，不會被存儲。
• 連接基於會話，服務器重啟時會清除。
• 儘可能使用SSH密鑰以提高安全性。
• 服務器僅接受來自本地MCP客戶端的連接（標準輸入輸出傳輸）。

故障排除

SSH連接問題

• 驗證主機是否可達：ping vpn-ap.local
• 檢查目標主機上的SSH是否正在運行：ssh pi@vpn-ap.local
• 確保憑證正確。

串口問題

• 檢查端口權限：ls -la /dev/ttyUSB*
• 將用戶添加到dialout組：sudo usermod -a -G dialout $USER
• 驗證設備是否已連接：dmesg | tail

📄 許可證

本項目採用MIT許可證。