Roo MCP Installer

Roo MCP Installer

説明

Roo Model Context Protocol（MCP）サーバーのインストールと管理を効率化するために設計されたコマンドラインユーティリティです。Git リポジトリから MCP サーバーのコードを取得し、依存関係、設定、Roo 環境への登録を処理します。

機能

• Git リポジトリからのインストール： GitHub リポジトリの URL（例：https://github.com/user/repo.git）または短縮形式のスラッグ（user/repo）を指定して、MCP を直接インストールします。
• サブディレクトリのサポート： コロン区切り（例：user/repo:subdir）を使用して、リポジトリ内の特定のサブディレクトリからインストールできます。
• インストール範囲： global（プロジェクト間で共有。通常は ~/.roo/mcps）と project（現在のディレクトリ専用。./.roo/mcps）の両方のインストール範囲をサポートします。
• プロジェクトタイプの自動検出： 標準的な設定ファイルに基づいて、プロジェクトタイプを識別します。
  • Node.js（package.json）
  • Python（requirements.txt、pyproject.toml）
  • Go（go.mod、main.go）
  • Rust（Cargo.toml）（現在も開発中のため、動作しない場合があります）
• 依存関係の管理： 検出されたパッケージマネージャーを使用して、プロジェクトの依存関係を自動的にインストールします。
  • npm install（失敗した場合は yarn install または pnpm install を確認）
  • pip install -r requirements.txt（失敗した場合は pip3 を確認）
  • poetry install（失敗した場合は pip install -e . を確認）
  • go mod download
  • cargo build（依存関係の取得も兼ねます）
• ビルドステップの実行： 必要に応じてビルドコマンドを自動的に実行します。
  • Go：go build -o <output_path> <target>
  • Node.js：ビルドスクリプトが存在し、main／bin フィールドに基づいて必要と判断される場合は、npm run build（または yarn／pnpm）を実行します。
• 環境変数の設定：
  • mcp.json（最優先）、.env.example、またはリポジトリの README.md ファイル内の JSON コードブロックを確認し、必要な環境変数を検出します。
  • 検出された変数の値をユーザーに入力するよう対話形式で促します。
  • 機密情報を示す名前の変数（例：KEY、SECRET、TOKEN、PASSWORD を含むもの）の入力値はマスクされます。
  • --skip-env フラグを使用すると、対話形式の設定をスキップできます。
• ツールの自動確認とインストール：
  • 必須のコマンドラインツール（git、npm、node、python、go、cargo、bun、tsc など）が存在するか確認します。
  • 既知のインストールコマンドがある場合（例：npm install -g bun）、不足しているツールをグローバルに自動インストールするかユーザーに確認します。
• インストール済み MCP の一覧表示： list コマンドは、グローバルとプロジェクトの両方の範囲にインストールされているすべての MCP を表示し、名前とインストールパスを示します。
• ログの表示： logs コマンドで、アプリケーションのログファイルを表示できます。
  • --lines / -n：最後の N 行のみを表示します。
  • --follow / -f：新しいエントリが追加されるたびにログファイルを継続的に監視します（tail -f に似ています）。
• リッチな TUI： rich ライブラリを使用し、スピナー、プログレスバー、スタイル付きテキスト、テーブル、対話形式のプロンプトを備えた高機能なターミナルユーザーインターフェイスを提供します。
• デバッグモード： --debug フラグを指定すると、トラブルシューティング用の詳細なログがコンソールとログファイルに出力されます。
• デモモード： --demo フラグ（install コマンド用）を指定すると、ファイルシステムを変更したりコマンドを実行したりせずに、UI と予定されている操作を表示してインストールプロセスをシミュレートします。

使用方法

スクリプトは python roo.py <command> [options] で実行します。

コマンド：

• install <repo_input> [options]
  • MCP サーバーをインストールまたは更新します。
  • <repo_input>：リポジトリの URL、user/repo 形式のスラッグ、または user/repo:subdir 形式のサブディレクトリです。
  • --scope <global|project>：インストールのスコープを設定します（デフォルト：global）。
  • --skip-env：環境変数の対話型プロンプトをスキップします。
  • --demo：デモモードでインストールを実行します（実際の変更は行いません）。
  • --debug：デバッグログを有効にします。
• list [options]
  • インストール済みの MCP サーバーを一覧表示します。
  • --debug：デバッグログを有効にします。
• logs [options]
  • ログファイルを表示します。
  • --lines N または -n N：末尾から N 行を表示します。
  • --follow または -f：ログ出力をリアルタイムで追跡します。
  • --debug：デバッグログを有効にします。

例

MCP をグローバルにインストールする：

python roo.py install username/my-cool-mcp

現在のプロジェクトに MCP をインストールする：

python roo.py install https://github.com/username/project-specific-mcp.git --scope project

環境変数の設定をスキップして、サブディレクトリから MCP をインストールする：

python roo.py install username/mono-repo:tools/my-mcp --skip-env

デバッグ出力を有効にして、インストールをシミュレートする：

python roo.py install username/test-mcp --demo --debug

インストール済みの MCP をすべて一覧表示する：

python roo.py list

最新のログエントリを表示する：

python roo.py logs

ログの末尾 100 行を表示する：

python roo.py logs --lines 100

ログをリアルタイムで追跡する：

python roo.py logs --follow

依存関係

• Python： tomllib を使用するため、バージョン 3.11 以降が必要です。
• Git： インストールされ、システムの PATH からアクセスできる必要があります。
• サードパーティ製 Python パッケージ： 下記の requirements.txt を参照してください。プロジェクトの種類によっては、追加のツール（Node.js/npm、Go、Rust/Cargo など）のインストールが必要になる場合があります。

要件ファイル（requirements.txt）

rich

ライセンス

MIT ライセンス

Copyright (c) 2025 [Your Name or Organization]

本ソフトウェアおよび関連ドキュメントファイル（以下「本ソフトウェア」）のコピーを取得するすべての者に対し、本ソフトウェアを無制限に取り扱うことを無償で許可します。これには、本ソフトウェアの使用、複製、変更、結合、公開、配布、サブライセンス、および／または販売の権利が含まれます。また、本ソフトウェアを提供された者にこれらを許可する権利も含まれます。ただし、以下の条件に従うものとします。

上記の著作権表示および本許諾表示は、本ソフトウェアのすべての複製または実質的な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、明示的か黙示的かを問わず、商品性、特定目的への適合性、および権利非侵害の保証を含むがこれらに限定されない、いかなる保証もありません。作者または著作権者は、契約、不法行為、その他の行為に起因するかを問わず、本ソフトウェアまたはその使用、その他の取引に起因または関連して生じるいかなる請求、損害、その他の責任についても責任を負いません。