Command Proxy

MCPコマンドプロキシサーバーは、CLIコマンドの実行を代理および監視するためのもので、特にExpo開発に適しています。

開発者ツール監視 #コマンドプロキシ #ログ監視 #ターミナルインタラクション #開発ツールローカル .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 20

更新時間 : 2025-04-28

MCPコマンドプロキシサーバーとは？

MCPコマンドプロキシサーバーは、コマンドラインツールの実行と管理を支援するインテリジェントなプロキシです。コマンドの出力をリアルタイムで表示し、キーボード入力を送信し、最近のログ記録を保存することができます。

MCPコマンドプロキシサーバーの使い方は？

MCPコマンドプロキシサーバーを設定して使用を開始するには、わずか数ステップです。まずサーバーをインストールし、次にターゲットコマンド（例：`expo start`）を起動し、最後にクライアントで接続を設定します。

適用シナリオ

開発者が長時間実行されるアプリケーションを効率的に管理およびデバッグする必要がある場合に適しています。たとえば、React Nativeプロジェクトの開発、ビルドプロセスの監視、およびリモートコラボレーションなどです。

主要機能

コマンドプロキシ任意のコマンドラインアプリケーションの実行をサポートし、MCPプロトコルを通じてそれとやり取りします。

ログ収集コマンドの標準出力とエラー出力を自動的にキャプチャして保存し、後で分析しやすくします。

キー押下転送ユーザーがクライアントから直接、実行中のプロセスにキーボード入力を送信できるようにします。

透明な体験最終ユーザーの体験が、コマンドを直接実行した場合と完全に同じになることを保証します。

利点と制限

利点

複数のコマンドラインツールをサポートする

リアルタイムログの表示

クロスプラットフォーム互換性が高い

制限

Node.jsとTypeScript環境のインストールが必要です

高頻度のキー入力操作には少し遅延が生じる可能性があります

使い方

MCPコマンドプロキシサーバーのインストール

システムにNode.js 18以上がインストールされていることを確認し、`pnpm install`を使用して依存関係をインストールします。

サーバーの起動

以下のコマンドを実行して、プロキシサーバーを起動し、実行するコマンドを指定します。

クライアントの設定

Cursorの設定で新しいMCPサーバーを追加し、名前、タイプ、URLなどの関連情報を入力します。

使用例

Expo開発サーバーの起動MCPコマンドプロキシサーバーを使用して、React Nativeプロジェクトを迅速に起動し管理します。

ビルドプロセスの監視CI/CDフローでMCPコマンドプロキシサーバーを使用して、ビルド状態を追跡します。

よくある質問

MCPコマンドプロキシサーバーをどのようにインストールしますか？

MCPコマンドプロキシサーバーはすべてのオペレーティングシステムをサポートしていますか？

実行中のサーバーをどのように停止しますか？

🚀 MCP コマンドプロキシサーバ

MCP（モデルコンテキストプロトコル）サーバです。これはコマンドラインツールのプロキシとして機能し、特にExpo開発向けに設計されていますが、任意のコマンドラインアプリケーションにも適用可能です。

🚀 クイックスタート

Cursorでの使用方法（Expoを例に）

Expoプロジェクトのディレクトリに移動します。
npx mcp-command-proxy --prefix "ExpoServer" --command "expo start" --port 8383 を実行します。
Cursorの設定 -> MCP -> 「+ 新しいMCPサーバを追加」をクリックします。
名前を「ExpoServer」、タイプを「SSE」、URLを http://localhost:8383/sse に設定します。
「保存」をクリックすると、CursorでこのMCPサーバを使用できるようになります。

⚠️ 重要提示

--port 8383 フラグを使用することをおすすめします。これにより、他のサーバとの競合を避けることができます。また、以下の指令を .cursorrules ファイルに追加することができます。

💡 使用建议

MCPの getRecentLogs ツールを使用して、Expoサーバの最新のログを取得できます。必要に応じて、sendKeyPress ツールを使用して、実行中のプロセスにキー入力を送信することができます。

✨ 主な機能

コマンドプロキシ：MCPサーバを通じて任意のCLIコマンドを実行できます。
ログ収集：実行中のプロセスのログをキャプチャして保存します（バッファサイズは設定可能）。
キー入力転送：クライアントのキー入力を実行中のプロセスに転送します。
透明な体験：エンドユーザーが見るコマンド出力は、直接実行した場合と全く同じです。
対話型コマンドサポート：Expoのような対話型CLIツールにも対応しています。
MCP統合：MCP SDKをベースに構築されており、Claudeや他のMCP対応のAIアシスタントとの統合が容易です。

🔧 技術詳細

サーバは擬似端末（PTY）で指定されたコマンドを起動します。
すべてのstdout/stderr出力は、以下のように処理されます。
- クライアントにリアルタイムでストリーミングされます。
- リングバッファに保存されます（サイズは設定可能、デフォルトは300行）。
クライアントのキー入力は、実行中のプロセスに転送されます。
サーバは以下のツールを提供します。
- 収集されたログを表示します。
- プロセスにキー入力を送信します。
- プロセスの現在の状態を取得します。

📚 ドキュメント

使用シーン

Expo開発：expo start を実行して対話し、同時にログを収集します。
ビルドプロセス：ビルドプロセスを監視し、ログを分析します。
長時間実行するサービス：サービスを監視し、最近のログ履歴を保持します。
リモートコマンド実行：リモートクライアントからコマンドを実行して監視します。

必要条件

Node.js（バージョン16以上）
npmまたはyarn
オペレーティングシステム（Windows、Linux、macOS）

📦 インストール

# リポジトリをクローンする
git clone https://github.com/hormold/mcp-command-proxy.git
cd mcp-command-proxy

# 依存関係をインストールする
pnpm install

# プロジェクトをビルドする
pnpm build

# 実行する
pnpm start

💻 使用例

基本的な使用法

mcp-command-proxy [オプション]

オプション

--version、 -v：パッケージのバージョンを出力します。
--help、 -h：使用方法のヘルプを出力します。
--port、 -p：サーバのポートを指定します。デフォルト値は3000です。
--prefix、 -x：コマンドの接頭辞を指定します。例えば「sudo」などです。
--command、 -c：実行するコマンドを指定します。

例

基本的なサーバを実行する

mcp-command-proxy --port 8080

コマンド接頭辞を付けて実行する

mcp-command-proxy --prefix "sudo" --command "npm start"

MCP統合

この実装には以下のMCPツールが含まれています。

getRecentLogs

最近のログエントリを取得します。

パラメータ

limit：返される最新のログエントリの数。デフォルト値は10です。

sendKeyPress

実行中のプロセスにキー入力イベントを送信します。

パラメータ

key：押されたキー。例えば「ArrowUp」や「Enter」などです。

例

Expoを実行する

mcp-command-proxy --command "expo start"

Claudeで使用する

claude run expo start

開発

# リポジトリをクローンする
git clone https://github.com/hormold/mcp-command-proxy.git
cd mcp-command-proxy

# 依存関係をインストールする
pnpm install

# プロジェクトをビルドする
pnpm build

# 開発モードを起動する
pnpm dev