MCPトンネル

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

特徴

• MCP を介して VM 上でシェル コマンドを実行する

• VMとの対話のためのWebベースの端末インターフェース

• 自動トンネリングにより、どこからでも VM にアクセス可能

• WebSocketベースのリアルタイム通信

Related MCP server: MCP SSH Agent

前提条件

• 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のコマンドラインに直接アクセスできるようにします。以下のセキュリティ対策を検討してください。

• トンネルを公開する前に強力な認証メカニズムを使用する

• 適切な検証を通じて実行できるコマンドを制限する

• 制限された環境での実行を検討する

• トンネルを通じて機密情報を公開しないでください