mcp-daemonize

mcp-daemonize

mcp-daemonize は、Claude Code や Cline などの AI エージェント向けに、長時間稼働するデーモン（開発サーバーなど）をシームレスに管理するための Model Context Protocol (MCP) サーバーです。AI エージェントがデーモンの起動、停止、監視を行い、ログにリアルタイムでアクセスできるようにすることで、高度な自動化とデバッグを実現します。

開発の背景

AI エージェントはコマンドを実行できますが、長時間稼働する開発サーバー（例：vite dev）の管理には適していません。通常、エージェントはコマンドの終了を待つため、開発中に継続して稼働するサーバーには向いていません。回避策として、ユーザーは別のシェルで開発サーバーを起動することがよくありますが、その場合、AI エージェントがサーバーのログに直接アクセスできず、自律的なデバッグができません。

mcp-daemonize は、以下の機能を提供することでこれらの問題を解決します。

• 終了を待たずにデーモンを起動するインターフェース。
• 実行中のデーモンを停止するツール。
• 実行中のデーモンのログをリアルタイムで確認するツール。

これらの機能により、mcp-daemonize は AI エージェントが開発サーバーを完全に管理し、その出力を監視して自動デバッグを行えるようにし、自律的なコーディングの可能性を大きく広げます。

ユースケース

• AI エージェントから開発サーバー（Vite、Next.js など）を起動、停止する。
• デバッグのために、実行中のデーモンのログをリアルタイムで確認、分析する。
• 永続的なバックグラウンドプロセスを必要とする開発ワークフローを自動化する。
• AI エージェントが長時間稼働するプロセスを自律的に管理、監視、デバッグできるようにする。

前提条件

1. Go 1.24.2 以降がインストールされていること。
2. （任意）mcp-daemonize をコンテナ内で実行する場合は Docker。

インストール

GitHub Releases からダウンロード

最新バージョンをダウンロードするには、Releases ページにアクセスしてください。

1. 最新のリリースページから、お使いのプラットフォーム用のアーカイブをダウンロードします。
2. アーカイブを展開し、バイナリを PATH 内のディレクトリに移動します。

wget https://github.com/mackee/mcp-daemonize/releases/download/vX.Y.Z/mcp-daemonize_X.Y.Z_Darwin_x86_64.tar.gz
tar -xzf mcp-daemonize_X.Y.Z_Darwin_x86_64.tar.gz
sudo mv mcp-daemonize /usr/local/bin/

ソースからビルド

go install を使用して最新バージョンをインストールできます（Go 1.24.2 以降）。

go install github.com/mackee/mcp-daemonize/cmd/mcp-daemonize@latest

MCP ホスト（例：Claude Code、Cline）での使用

以下の設定を MCP ホストの設定（例：mcp.json）に追加します。

{
  "servers": {
    "daemonize": {
      "command": "/path/to/mcp-daemonize",
      "args": [],
      "env": {}
    }
  }
}

/path/to/mcp-daemonize を、ビルドしたバイナリの実際のパスに置き換えてください。

使用方法

mcp-daemonize は AI エージェント向けに以下のツールを提供します。

ツール

• daemonize_start

  • 長時間稼働するプロセス（開発サーバーなど）をデーモンとして起動します。
  • パラメーター：
    • name（string、必須）：デーモンの名前。
    • command（string[]、任意）：実行するコマンド（例：["npm", "run", "dev"]）。
    • workdir（string、必須）：デーモンの作業ディレクトリ（絶対パス）。

• daemonize_stop

  • 名前を指定して実行中のデーモンを停止します。
  • パラメーター：
    • name（string、必須）：停止するデーモンの名前。

• daemonize_list

  • 現在実行中のすべてのデーモンを一覧表示します。
  • パラメーター： なし

• daemonize_logs

  • 実行中のデーモンから最新のログを取得します。
  • パラメーター：
    • name（string、必須）：デーモンの名前。
    • tail（number、必須）：ログ末尾から読み取る行数。

ワークフローの例

1. daemonize_start を使用して、開発サーバーをデーモンとして起動します。
2. daemonize_logs を使用して、サーバーの出力をリアルタイムで監視します。
3. 終了したら、daemonize_stop でサーバーを停止します。

ライセンス

このプロジェクトは、MIT オープンソースライセンスの条件に基づいてライセンスされています。詳細は LICENSE を参照してください。