Autobuildmcp

🚀 AutoBuildMCP: MCPを活用したビルド自動化サーバー

AutoBuildMCPは、Model Context Protocol (MCP) をベースにした堅牢なプロファイルベースのビルド自動化サーバーです。CursorのようなMCP互換クライアントが、複数のプロジェクトにまたがるビルドプロセスをシームレスに管理、実行、監視できるようになります。

このサーバーは、持続的でステートフルなアーキテクチャを採用しており、ビルドキューを使用して同時操作を管理し、システムの過負荷を防ぎます。

✨ 主な機能

• プロファイルベースの管理：各プロジェクトに独自のビルド「プロファイル」を定義できます。各プロファイルには、プロジェクトのパス、ビルドコマンド、環境変数、タイムアウトが含まれます。
• 永続的な状態：すべてのビルドプロファイルは、単純な builds.json ファイルに保存されるため、サーバーの再起動後も設定が保持されます。
• ビルドキューイングシステム：高度なキューイングシステムが、同時ビルドのプール（デフォルト: 2）を管理し、複数の同時リクエストによるサーバーの過負荷を防ぎます。新しいビルドはキューに入れられ、空きスロットができると実行されます。
• 非同期、非ブロッキング実行：ビルドはバックグラウンドプロセスとして実行されるため、ビルド中でもサーバーは応答性を維持し、他のAPI呼び出しを処理できます。
• フルライフサイクル管理：ビルドの設定、開始、監視、停止、削除を行うための完全なツールセットが用意されています。
• ログキャプチャ：各ビルド実行の完全な stdout と stderr が、デバッグを容易にするために専用のログファイルにキャプチャされます。
• 再起動耐性：サーバーは、実行中に再起動された場合、ビルドを「不明」としてマークし、「実行中」の状態が固まるのを防ぎます。

📦 インストール

セットアッププロセスは、WindowsとLinux/macOS環境の両方で簡素化されています。

1. 環境の構築

このスクリプトは、Python仮想環境を作成し、requirements.txt からすべての必要な依存関係をインストールします。これには、プロセス管理用の psutil も含まれます。

Windowsの場合：

.\build.bat

Linux/macOSの場合：

./build.sh

2. サーバーの起動

これにより、AutoBuildMCPサーバーとそのバックグラウンドビルドワーカーが起動します。サーバーは http://localhost:5307 で利用可能になります。

Windowsの場合：

.\run.bat

Linux/macOSの場合：

./run.sh

サーバーが起動し、MCPクライアントからのリクエストを受け付ける準備ができました。

📚 ドキュメント

サーバーは、任意のMCP互換クライアントから呼び出すことができる一連のツールを公開しています。

configure_build

ビルドプロファイルを作成または更新します。

• profile_name (str)：プロファイルの一意の名前（例: my-web-app）。
• project_path (str)：プロジェクトのルートディレクトリへの絶対または相対パス。
• build_command (str)：ビルドを実行するためのシェルコマンド（例: npm run build）。
• environment (dict, オプション)：ビルドプロセスに設定する環境変数の辞書。
• timeout (int, オプション)：ビルドのタイムアウト（秒）（未実装）。

toggle_autobuild

特定のプロファイルの自動ビルドファイルウォッチャーを有効または無効にします。

• profile_name (str)：変更するプロファイルの名前。
• enabled (bool)：自動ビルドを有効にするには true、無効にするには false を設定します。

list_builds

すべての構成されたビルドプロファイルとその最後の状態をリストします。

get_build_status

特定のビルドプロファイルの現在の状態を取得します。

• profile_name (str)：確認するプロファイルの名前。
• 戻り値：状態は、configured、queued、running、succeeded、failed、stopped、または unknown のいずれかです。

start_build

特定のプロファイルのビルドリクエストをキューに追加します。

• profile_name (str)：ビルドするプロファイルの名前。
• 戻り値：確認メッセージとキュー内のビルドの位置。

stop_build

現在実行中のビルドを停止します。

• profile_name (str)：停止する実行中のプロファイルの名前。

delete_build_profile

サーバーからビルドプロファイルを削除します。

• profile_name (str)：削除するプロファイルの名前。

get_build_log

特定のプロファイルの最後の実行のログファイルを取得します。

• profile_name (str)：プロファイルの名前。
• lines (int, オプション)：指定された場合、ログの最後のN行のみを返します（ログの末尾追跡）。

自動ビルドシステム

サーバーには、プロファイルごとに有効にできる強力な自動ビルドシステムが含まれています。

動作原理

1. 有効化：toggle_autobuild ツールを使用して、特定のプロファイルの機能を有効にします。
2. 監視：サーバーは、プロファイルの project_path のファイル変更を監視し始めます。
3. デバウンス：変更が検出されると、5秒のカウントダウンタイマーが開始されます。別の変更が発生すると、タイマーがリセットされます。これにより、複数のファイルを保存する際の大量のビルドが防止されます。
4. トリガー：タイマーが完了すると、サーバーはプロファイルの状態を確認します。
   • プロファイルがアイドル状態の場合、新しいビルドがキューに追加されます。
   • プロファイルがビジー（running または queued）状態の場合、rebuild_on_completion フラグが設定されます。ビルドワーカーは、現在のビルドが完了するとすぐに、自動的にビルドを再キューに入れます。

builds.json 状態ファイル

このファイルはサーバーの中心であり、すべてのプロファイル構成とその最後の実行状態を保存しています。システムの現在の状態を確認するために参照できます。

builds.json の例：

{
  "my-web-app": {
    "project_path": "C:/Users/Admin/projects/my-app",
    "build_command": "npm install && npm run build",
    "environment": {
      "NODE_ENV": "production"
    },
    "timeout": 600,
    "status": "succeeded",
    "autobuild_enabled": true,
    "rebuild_on_completion": false,
    "last_run": {
      "run_id": "08f7e57e-e46c-4ac3-b564-f3588018b9fd",
      "pid": 12052,
      "start_time": "2025-06-29T22:45:00.123456Z",
      "end_time": "2025-06-29T22:46:12.123456Z",
      "log_file": "logs/08f7e57e-e46c-4ac3-b564-f3588018b9fd.log",
      "outcome_note": "Build status is unknown; server was restarted during execution."
    }
  }
}