ConsoleSpy

ConsoleSpy

2026年8月にアーカイブされました。 ConsoleSpyは、ブラウザーのコンソールログをAIコーディングエージェントに渡す方法がサポートされていなかった頃、そのログをエージェントに届けていました。現在は、ブラウザーベンダーやモデルベンダー自身が提供するツールがいくつもあります。以下を参照し、代わりにそちらをお使いください。コードは参考用に残してありますが、メンテナンスは終了しています。

代わりに使えるツール

ツール	備考
Chrome DevTools MCP	Googleの公式サーバーです。ソースマップ付きスタックトレースを含むコンソールメッセージに加え、ネットワーク、パフォーマンス、DOMを調査できます。
Chrome DevTools auto-connect	Chrome 144以降に対応しています。セッションごとの権限確認を経て、すでに開いているChromeにMCPサーバーを接続します。デバッグポートも、別のプロファイルも必要ありません。
Claude in Chrome	Anthropicの拡張機能とネイティブメッセージングブリッジです。claude --chromeを実行すると、エージェントが実際にログイン済みのブラウザーからコンソール出力を読み取ります。有料のAnthropicプランが必要です。
Safari MCP server	WebKit向けのApple版です。2026年7月に提供が開始されました。

これは何だったのか

2025年3月、MCPの登場から約4か月が経っていましたが、エージェントは事実上ブラウザーの情報を得られませんでした。デバッグするには、コンソール出力をチャットウィンドウにコピー＆ペーストしていました。ConsoleSpyは、3つの要素でその状況を変えました。アクティブなタブのconsole.*をフックするChrome拡張機能、ポート3333で動作するローカルのExpressコレクター、そしてSSE経由でCursorにログを公開するMCPサーバーです。

アーカイブした理由

ConsoleSpyが他のツールにはできず、実現できたのは、すでにログインしていた実際のブラウザープロファイルから、受動的にログを取得することでした。この利点は時間とともに重要性を増しました。Chrome 136ではデフォルトのプロファイルでのリモートデバッグがブロックされたため、Chrome DevTools Protocolを使うツールはすべて、セッション情報のない一時的なプロファイルを起動する必要がありました。拡張機能にはその問題がありませんでした。

今では、両方向からこのギャップが解消されています。Chrome 144の自動接続では、権限確認ダイアログを通じて使用中のブラウザーでデバッグセッションを開始できます。また、Claude in Chromeはネイティブメッセージングブリッジを使うため、ポートもMCPの設定も不要です。どちらもファーストパーティ製で、コンソールログ以外の情報も幅広く扱えます。また、どちらも2つのプロセスを実行する必要がありません。

今ならこうする

• 検索と置換による設定。 ポート3333は4つのファイルにハードコードされており、READMEではその文字列をgrepするよう案内していました。設定値を1つ用意し、一度だけ読み込む方法なら、追加コストはありませんでした。
• 2つのプロセスとSSEブリッジ。 コレクターとMCPサーバーは別々に動作し、supergatewayでつないでいました。標準入出力を使えば、2つ目のプロセスもクライアントの手動設定も不要でした。
• プロトコルではなく、1つのエディターに依存。 パッケージ名はconsole-to-cursor-mcpでした。MCPの要点はクライアントを入れ替えられることです。名前とドキュメントにも、それを反映すべきでした。

2025年当時の課題で、今も未解決のものが1つあります。そして、それこそが重要な課題です。コンソールやネットワークの出力は、エージェントのコンテキストウィンドウを埋め尽くします。Anthropic自身のドキュメントでも、「ログは冗長になる可能性がある」ため、エージェントに確認するパターンを伝えるよう推奨しています。ログの取得は簡単な部分でした。スタックの署名による重複排除、クリーンな基準値との比較、前回の編集から変わった点だけの提示といったトリアージは、今もほとんど手作業です。

ライセンス

MIT