MCP Command Proxy

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

MCP（モデルコンテキストプロトコル）サーバです。コマンドラインインターフェイス（CLI）コマンドの代理として機能し、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. サーバは以下のツールを提供します：
   • 収集されたログを表示する。
   • プロセスにキー入力を送信する。
   • プロセスの現在の状態を取得する。

📦 インストール

必要条件

• Node.js 18+
• TypeScript
• pnpm（推奨）またはnpm

手順

# 依存関係のインストール
pnpm install

# プロジェクトのビルド
pnpm build

# 直接実行
pnpm start -- --prefix "MyServer" --command "expo start"

# またはグローバルインストール
pnpm install -g

次に、以下を実行します：
mcp-command-proxy --install

📚 ドキュメント

開発手順

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

# 依存関係のインストール
pnpm install

# プロジェクトのビルド
pnpm build

# 開発モードで実行
pnpm dev

📄 ライセンス

MIT