MCP Tunnel

MCPトンネル

VMマシンのコマンドラインへのアクセスを可能にするシンプルなMCP（Model Context Protocol）サーバーです。起動すると、ホストをWebにトンネリングし、MCP経由でアクセスできるようになります。

特徴

• MCP を介して VM 上でシェル コマンドを実行する
• VMとの対話のためのWebベースの端末インターフェース
• 自動トンネリングにより、どこからでも VM にアクセス可能
• WebSocketベースのリアルタイム通信

前提条件

• Node.js (v18以降)

インストールと使用方法

npx で実行 (インストール不要)

グローバルインストール

地域開発

発達

バックエンドとフロントエンドの両方でホットリロードを使用して開発サーバーを実行します。

建物

本番環境用にフロントエンドとバックエンドの両方を構築します。

使用法

1. MCP サーバーを起動します。

プロジェクトがビルドされ、サーバーが起動します。デフォルトでは、トンネルが自動的に作成されます。自動トンネリングを無効にするには、 --no-tunnelフラグを使用してください。

2. サーバーが起動し、stderr に出力を提供します (stdout での MCP 通信を妨害しないようにするため)
3. MCP を使用して、次のツールを使用してサーバーと対話します。

利用可能なMCPツール

• execute_command : VM上でシェルコマンドを実行する
  • パラメータ: { "command": "your shell command" }
• start_tunnel : VMインターフェースにアクセスするためのWebトンネルを作成する
  • パラメータ: { "port": 8080, "subdomain": "optional-subdomain" }

ウェブインターフェース

トンネルを開始すると、トンネルから提供されたURLでWebベースのターミナルインターフェースにアクセスできます。このインターフェースでは、以下の操作が可能です。

• VM内で直接コマンドを実行する
• コマンド出力をリアルタイムで確認
• ウェブアクセスのあるあらゆるデバイスから VM を操作します

環境変数

サーバーを構成するための.envファイルを作成します。

セキュリティに関する考慮事項

このツールは、VMのコマンドラインに直接アクセスできるようにします。以下のセキュリティ対策を検討してください。

• トンネルを公開する前に強力な認証メカニズムを使用する
• 適切な検証を通じて実行できるコマンドを制限する
• 制限された環境での実行を検討する
• トンネルを通じて機密情報を公開しないでください