MCP Tunnel

🚀 MCP トンネルサーバー

簡単な MCP（モデルコンテキストプロトコル）サーバーです。MCP を通じて VM マシンのコマンドラインインターフェイスにアクセスできます。起動時に自動的にトンネルを作成し、VM を Web からアクセス可能にします。

✨ 主な機能

• VM 上でシェルコマンドを実行する
• Web ベースのターミナルインターフェイスで VM とやり取りする
• 自動トンネル機能により、任意の場所から VM にアクセスできる
• WebSocket によるリアルタイム通信

📦 インストール

前提条件

• Node.js (v18 以上)

インストール方法

npx を使用する場合（インストール不要）

npx mcp-cli

グローバルインストール

npm install -g mcp-cli
mcp-cli

ローカル開発用

# リポジトリをクローン
git clone [リポジトリのURL]
cd mcp-cli

# 依存関係をインストール
npm install

💻 使用例

開発

ホットリロード付きで開発サーバーを起動し、フロントエンドとバックエンドを同時に更新します。

npm run dev

ビルド

本番環境用のフロントエンドとバックエンドをビルドします。

npm run build-all

サーバーの起動

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

# 自動トンネル機能付きで起動
npm start

# 自動トンネル機能なしで起動
npm start -- --no-tunnel

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

2. サーバーが起動すると、stderr に出力が表示されます（MCP 通信の stdout を妨げないように）。

3. MCP ツールを使用してサーバーとやり取りします。

利用可能な MCP ツール

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

Web インターフェイス

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

• VM 上で直接コマンドを実行する
• コマンドの出力をリアルタイムで確認する
• Web 対応の任意のデバイスで VM とやり取りする

環境変数

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

# サーバー設定
PORT=8080

# Localtunnel 設定
LOCALTUNNEL_SUBDOMAIN=your-preferred-subdomain

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

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

• トンネルを公開する前に、強力な認証メカニズムを使用する
• 適切な認証により、実行可能なコマンドを制限する
• 制限された環境で実行することを検討する
• トンネルを通じて機密情報を漏洩しないようにする