Command Proxy

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

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

🚀 クイックスタート

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

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

⚠️ 重要提示

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

💡 使用建议

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

✨ 主な機能

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

🔧 技術詳細

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

📚 ドキュメント

使用シーン

• 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：実行するコマンドを指定します。

例

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

mcp-command-proxy --port 8080

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

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

MCP統合

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

getRecentLogs

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

パラメータ

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

sendKeyPress

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

パラメータ

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

例

1. Expoを実行する

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

2. 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

📄 ライセンス

MIT