MCP Remote Access

🚀 MCP互換クライアント用のSSHとシリアルポートアクセス

MCP互換クライアント（例えば、Codex CLIやClaude Code）に対してSSHとUART/シリアルポートアクセスを提供するMCPサーバーです。Raspberry Pi、組み込みシステム、IoTデバイスなどのリモートデバイスを直接制御できます。

🚀 クイックスタート

このMCPサーバーを使用することで、MCP互換クライアントを通じてSSHとシリアルポートにアクセスできます。以下の手順でセットアップしてください。

✨ 主な機能

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

💻 使用例

Raspberry PiへのSSH接続

ユーザー名pi、パスワードraspberryでvpn-ap.localのPiに接続する

クライアントは以下を使用します。

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 で通信します。

VID 0x10c4、PID 0xea60のUSBシリアルデバイスに115200ボーレートで接続する

クライアントは以下を使用します。

1. serial_connect_match でポートを選択します。
2. serial_send / serial_read で通信します。

シリアルプロンプト自動化

UARTに接続し、rootとしてログイン（パスワードsummit）し、シェルプロンプトを待つ

クライアントは以下を使用します。

1. serial_connect または serial_connect_match でポートを開きます。
2. serial_expect でプロンプトを待機し、応答を送信します。

🔒 セキュリティに関する注意事項

• SSHパスワードはメモリ内でのみ扱われ、保存されることはありません。
• 接続はセッションベースであり、サーバーの再起動時にクリアされます。
• 可能な場合はSSHキーを使用して、より高いセキュリティを確保してください。
• サーバーはローカルのMCPクライアント（stdioトランスポート）からの接続のみを受け付けます。

🛠️ トラブルシューティング

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