Commander MCP

🚀 commander - mcp

Model Context Protocol (MCP) サーバーで、バックグラウンドプロセスの管理を行います。Rust で構築された commander - mcp は、MCP プロトコルを通じて PMDaemon を使用し、バックグラウンドプロセスの実行、監視、管理を行う強力なツールを提供します。

🚀 クイックスタート

前提条件

• Rust 1.70 以上（ソースからビルドする場合）
• Cargo（Rust と一緒にインストールされます）

インストール

インストールスクリプトを使用する（推奨）

commander - mcp をインストールする最も簡単な方法は、インストールスクリプトを使用することです。

curl -fsSL https://raw.githubusercontent.com/towry/commander-mcp/main/install.sh | bash

または、スクリプトをダウンロードして確認してから実行することもできます。

curl -fsSL https://raw.githubusercontent.com/towry/commander-mcp/main/install.sh -o install.sh
chmod +x install.sh
./install.sh

サポートされているプラットフォーム:

• macOS Apple Silicon (M1/M2/M3) - aarch64 - apple - darwin
• Linux x86_64 - x86_64 - unknown - linux - gnu

スクリプトは以下のことを行います。

1. プラットフォームを自動検出します。
2. 最新のリリースバイナリをダウンロードします。
3. /usr/local/bin にインストールします。
4. インストールを検証します。

ソースからビルドする

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

# プロジェクトをビルドする
cargo build --release

# サーバーを起動する
cargo run --release

使用方法

MCP サーバーは、MCP プロトコルを使用して標準入出力を介して通信します。MCP Inspector を使用してテストすることができます。

# MCP Inspector をインストールする（Node.js が必要）
npm install -g @modelcontextprotocol/inspector

# インストールスクリプトでインストールした場合
npx @modelcontextprotocol/inspector commander-mcp

# ソースから実行している場合
npx @modelcontextprotocol/inspector cargo run --release

Claude Desktop と一緒に使用する

この MCP サーバーを Claude Desktop と一緒に使用するには、Claude Desktop の設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "commander": {
      "command": "/usr/local/bin/commander-mcp"
    }
  }
}

または、ソースから実行している場合は、以下のようにします。

{
  "mcpServers": {
    "commander": {
      "command": "cargo",
      "args": ["run", "--release", "--manifest-path", "/path/to/commander-mcp/Cargo.toml"]
    }
  }
}

✨ 主な機能

• MCP プロトコルサポート: 公式の Rust MCP SDK (v0.7) をベースに構築されています。
• PMDaemon 統合: 組み込みの監視とログ管理機能を備えた強力なプロセス管理。
• プロセス管理ツール: プロセスの実行、終了、再起動、監視が可能です。
• 永続的なログ: プロセスの出力はファイルに保存され、いつでも読み取ることができます。
• クロスプラットフォーム: Linux、Windows、macOS で動作します。
• 標準入出力トランスポート: stdin/stdout を介して通信するため、簡単に統合できます。
• 非同期ランタイム: 高性能な非同期操作のために Tokio をベースに構築されています。
• 型安全: Rust の型システムを活用して信頼性を高めています。

💻 使用例

基本的な使用法

MCP サーバーを使用してバックグラウンドプロセスを管理する基本的な例を示します。

# MCP Inspector を使用してサーバーをテストする
npx @modelcontextprotocol/inspector commander-mcp

高度な使用法

Claude Desktop と一緒に MCP サーバーを使用する例を示します。

{
  "mcpServers": {
    "commander": {
      "command": "/usr/local/bin/commander-mcp"
    }
  }
}

📚 ドキュメント

利用可能なツール

run

コマンドをバックグラウンドで実行します。

説明: コマンドをバックグラウンドで実行します。ツールは起動後 1 秒間待機して、早期のエラーを検出します。他のツールで使用できるプロセス ID と初期ログを返します。

パラメータ:

• command (文字列): 実行するコマンド

例:

{
  "command": "npm run dev"
}

レスポンス (JSON):

{
  "process_id": "npm_run",
  "command": "npm run dev",
  "message": "Started process 'npm_run'",
  "logs": "... initial log output (if available) ..."
}

エラーレスポンス (プロセスがすぐに失敗した場合):

{
  "error": "Process 'npm_run' failed to start. Logs:\n... error logs ..."
}

注意事項:

• ツールはプロセスを起動してから 1 秒間待機して、早期のエラーを検出します。
• この時間内にプロセスがエラー状態または停止状態に入った場合、エラーが返されます。
• 初期ログ（最大 100 行）は、利用可能な場合にレスポンスに含まれます。
• これにより、「アドレスがすでに使用されている」などの問題を、read ツールを別途呼び出すことなく検出できます。

kill

以前に起動したプロセスをその ID で終了します。

パラメータ:

• process_id (文字列): 終了するプロセスの ID

例:

{
  "process_id": "npm_run"
}

レスポンス (JSON):

{
  "process_id": "npm_run",
  "message": "Stopped process 'npm_run'"
}

kill_all

すべての実行中のプロセスを終了します。

パラメータ: なし

例: パラメータなしで呼び出すと、すべてのプロセスが停止します。

レスポンス (JSON):

{
  "stopped_count": 3,
  "message": "Stopped 3 process(es)"
}

read

プロセスの ID を指定して、その標準出力を読み取ります。

説明: 最近のログ出力を返します（デフォルト: 最後の 1000 行）。

パラメータ:

• process_id (文字列): 出力を読み取るプロセスの ID
• lines (数値, オプション): 返すログの最大行数（デフォルト: 1000）

例:

{
  "process_id": "npm_run",
  "lines": 500
}

レスポンス (JSON):

{
  "process_id": "npm_run",
  "logs": "... log output here ..."
}

restart

以前に実行したプロセスをその ID で再起動します。

パラメータ:

• process_id (文字列): 再起動するプロセスの ID

例:

{
  "process_id": "npm_run"
}

レスポンス (JSON):

{
  "process_id": "npm_run",
  "message": "Restarted process 'npm_run'"
}

list

現在実行中または停止しているすべてのプロセスをリストします。

パラメータ: なし

レスポンス (JSON):

{
  "processes": [
    {
      "name": "npm_run",
      "status": "running",
      "pid": 12345,
      "started_at": "2025-10-03 17:14:55 UTC",
      "uptime_seconds": 120,
      "restarts": 0,
      "cpu_usage": 2.5,
      "memory_mb": 45
    }
  ]
}

すべてのプロセスのステータス、PID、開始時刻、稼働時間、CPU 使用率、メモリ使用率、再起動回数が返されます。

仕組み

1. プロセス管理: Rust で書かれた高性能なプロセスマネージャーである PMDaemon を使用します。
2. プロセス ID: コマンドのキーワードに基づいて自動生成されます（例: npm run dev → npm_run）。
3. 永続的なログ: すべてのプロセス出力はログファイルに保存され、いつでも読み取ることができます。
4. リアルタイム監視: CPU、メモリ使用率、およびプロセスの状態を追跡します。
5. クロスプラットフォーム: Linux、Windows、macOS をネイティブにサポートしています。

主要な機能

• 永続的なログ管理: ログはファイルに保存され、いつでも読み取ることができます（ライブ出力だけでなく）。
• プロセスごとのログアクセス: 特定のプロセスのログを読み取ることができます。
• 外部依存なし: PMDaemon は Rust ライブラリであり、外部バイナリは必要ありません。
• クロスプラットフォーム: Windows、macOS、Linux をネイティブにサポートしています。
• 組み込み監視: CPU とメモリの追跡機能が含まれています。
• 直接 API: Rust API を通じたプログラムによる制御が可能です。

開発

テストの実行

# すべてのテストを実行する
cargo test --all-features --verbose

# 出力を表示しながらテストを実行する
cargo test -- --nocapture

コード品質

このプロジェクトは Rust のベストプラクティスに従い、自動リリースのためにコンベンショナルコミットを使用しています。

# コードをフォーマットする（コミットする前に必須）
cargo fmt --all

# フォーマットをチェックする
cargo fmt --all -- --check

# リンティングを実行する
RUSTFLAGS="-D warnings" cargo clippy --workspace --all-targets --all-features --verbose

Just コマンドを使用する

このプロジェクトには、開発を簡単にするための justfile が含まれています。

# フォーマット、リンティング、テストを実行する
just check

# コードをフォーマットする
just format

# リンティングを実行する
just lint

# テストを実行する
just test

# リリースバイナリをビルドする
just build

プロジェクト構造

commander-mcp/
├── src/
│   ├── main.rs              # MCP サーバーのセットアップが記載されたエントリーポイント
│   ├── process_server.rs    # MCP ツールの実装
│   └── process_manager.rs   # プロセス管理のための PMDaemon ラッパー
├── Cargo.toml               # プロジェクトの依存関係とメタデータ
└── README.md                # このファイル

関連リンク

• PMDaemon - このサーバーを動かすプロセスマネージャーライブラリ
• MCP Protocol - Model Context Protocol の仕様
• Rust MCP SDK - Rust 用の公式 MCP SDK