ConsoleSpy: カーソル用MCPサーバー

ブラウザ コンソールのログをキャプチャし、モデル コンテキスト プロトコル (MCP) を通じてカーソル IDE で使用できるようにするツール。

概要

このツールは次のものから構成されます:

1. ブラウザからコンソールログをキャプチャするサーバー
2. これらのログをCursorで利用できるようにするMCPサーバー
3. コンソールログをサーバーに送信するブラウザ拡張機能

インストール

サーバーのセットアップ

1. このリポジトリをクローンします:
   git clone https://github.com/mgsrevolver/consolespy.git cd consolespy
2. 依存関係をインストールします:
   npm install
3. セットアップ スクリプトを実行して、カーソルの MCP 接続を構成します。
   ./setup.sh

ブラウザ拡張機能のインストール

1. Chromeウェブストアから拡張機能をインストールしますまたは開発者モードで拡張機能を読み込みます。
   • Chromeを開いてchrome://extensions/に移動します。
   • 「開発者モード」を有効にする（右上隅のトグル）
   • 「解凍して読み込む」をクリックし、このリポジトリからextensionフォルダを選択します。

使用法

サーバーの起動

1. コンソール ログ サーバーを起動します。
   node mcp-server.js
2. 別のターミナルで、MCP サーバーを起動します。
   npx supergateway --port 8766 --stdio "node console-spy-mcp.js"

あるいは、起動スクリプトを使用して、両方のサーバーを同時に起動することもできます。

カーソルの設定

セットアップ スクリプトを実行した後でも、Cursor に MCP サーバーを手動で追加する必要があります。

1. 設定 > 機能 > カーソル内のMCPに移動します
2. 次のようにして新しい MCP サーバーを追加します。
   • 名前: ConsoleSpy
   • タイプ: sse
   • URL: http://localhost:8766/sse

拡張機能の使用

1. ブラウザの拡張機能アイコンをクリックしてオン/オフを切り替えます
2. 有効にすると、現在のタブのすべてのコンソールログがサーバーに送信されます。
3. カーソルでは、MCPインターフェースを通じてこれらのログにアクセスできるようになりました。

カスタマイズ

コンソールログサーバポートの変更

コンソール ログ サーバーに別のポート (デフォルトは 3333) を使用する必要がある場合は、複数の場所でポートを更新する必要があります。

1. mcp-server.jsで、ポート変数を変更します。
   const port = 3333; // Change to your desired port
2. console-spy-mcp.jsで、新しいポートに合わせて URL を更新します。
   const CONSOLE_SERVER_URL = 'http://localhost:3333/mcp'; // Change 3333 to your port
3. ブラウザ拡張機能のcontent.jsで、サーバー URL を更新します。
   const serverUrl = 'http://localhost:3333/console-logs'; // Change 3333 to your port
4. start-servers.shを使用する場合は、そこでもポート参照を更新します。

**重要:**すべての場所で同じポート番号を使用する必要があります。一貫性を保つため、プロジェクトファイル内で「3333」をグローバル検索し、すべてのインスタンスを希望のポート番号に置き換えることをお勧めします。

すでにポート 3333 を使用している別のアプリケーションでローカルでテストしている場合、ツールが正しく動作するためにこのポートを変更することが不可欠です。

トラブルシューティング

• 両方のサーバーが稼働していることを確認してください
• デバッグしているタブでブラウザ拡張機能が有効になっていることを確認します
• カーソルの設定にMCPサーバーを追加したことを確認してください
• ログが表示されない場合は、ページを更新するか、サーバーを再起動してください。

ライセンス

MITライセンス