Server Watch

server-watch-mcp

実行中の任意のコマンドを監視して出力を取得し、MCP サーバーとして公開するシンプルな CLI ラッパーです。サーバーログ、ビルド出力、その他のプロセス出力にアクセスする必要がある開発ワークフローに最適です。

機能

• HTTP ベースの MCP サーバー - クライアントが接続できるスタンドアロンサービスとして実行します
• リアルタイムのログ取得 - 任意のコマンドの stdout と stderr を取得します
• 循環バッファーストレージ - メモリ上に直近 5000 件のログエントリーを保持します
• 2 つの MCP ツール：
  • get_logs - ストリームの種類で絞り込んで、直近のログを取得します
  • search_logs - 大文字と小文字を区別しない部分文字列検索でログを検索します

インストール

npm install -g server-watch-mcp
# or
pnpm add -g server-watch-mcp
# or in your project
pnpm add -D server-watch-mcp

使用方法

1. MCP サーバーを Claude Code に追加する

claude mcp add -s user -t sse server-watch-mcp http://localhost:6280/sse

次のように設定されます：

{
  "mcpServers": {
    "server-watch-mcp": {
      "type": "sse", // Even though SSE is deprecated, Claude Code only supports SSE 
      "url": "http://localhost:6280/sse"
    }
  }
}

2. コマンドとともに MCP サーバーを起動する

オプション 1：コマンドの実行時にラップする

# Monitor a development server
server-watch-mcp npm run dev

# Monitor a build process
server-watch-mcp npm run build:watch

# Monitor any command
server-watch-mcp python app.py

オプション 2：package.json（またはスクリプトファイル）でコマンドをラップする

// In your package.json
{
  "scripts": {
    "dev": "server-watch-mcp next dev --turbo",
  }
}

サーバーは次の処理を行います：

• ポート 6280（または環境変数 SERVER_WATCH_MCP_PORT）で HTTP サーバーを起動します
• コマンドを子プロセスとして実行します
• コマンドからのすべての出力を取得します
• 子プロセスが終了しても実行を継続します

3. Claude でツールを使用する

接続すると、次のツールを使用できます：

• 直近のログを取得：「stderr の直近 50 件のログを表示して」
• ログを検索：「ログ内のエラーを検索して」
• 出力を監視：「開発サーバーで何が起きている？」

環境変数

SERVER_WATCH_MCP_PORT - デフォルトのポート（6280）を上書きします

SERVER_WATCH_MCP_PORT=6281 server-watch-mcp npm run dev

開発

# Install dependencies
pnpm install

# Build
pnpm run build

# Run tests
pnpm test

# Run in development
pnpm run dev

ライセンス

ISC