Structurizr DSL Debugger for Cursor

Cursor 向け Structurizr DSL デバッガー

Cursor IDE で Structurizr DSL の構文上の問題をデバッグするための専用ツールです。このツールは Model Context Protocol（MCP）を使って Cursor と連携し、Structurizr DSL のエラーをリアルタイムで検出、分析し、修正案を提示します。

機能

• 🔍 リアルタイムエラー検出 - Structurizr DSL ファイルの構文エラーを自動的に取得します
• 🛠️ 修正案の提示 - よくある DSL エラーを修正するための的確な提案を提示します
• 🔄 ブラウザー連携 - Structurizr のページを開いた Chrome に接続し、エラーを監視します
• 🧩 Cursor IDE との連携 - MCP ツールを使って Cursor とシームレスに連携します
• ⚙️ 設定可能 - Structurizr のポートをカスタマイズできます
• 📊 エラー履歴 - 取得したエラーのログを保存し、後から確認できます

要件

• Node.js 14+
• Cursor IDE
• リモートデバッグを有効にした Google Chrome
• ローカルで実行中の Structurizr Lite（通常はポート 8080）

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/your-username/structurizr-dsl-debugger.git
   cd structurizr-dsl-debugger
   

2. 依存関係をインストールします：

   npm install
   

3. Cursor IDE との連携を設定します：

   npm run setup
   

使用方法

Structurizr の起動

1. Structurizr Lite を起動します（まだ起動していない場合）：

   docker run -it --rm -p 8080:8080 -v /path/to/workspace:/workspace structurizr/lite
   

デバッガーの使用

1. リモートデバッグを有効にして Chrome を起動します：

   google-chrome --remote-debugging-port=9222 http://localhost:8080
   

2. DSL デバッガーを起動します：

   # Standard start (default port 8080)
   npm start
   
   # With custom Structurizr port
   STRUCTURIZR_PORT=9090 npm start
   
   # Using the launcher with interactive prompts
   npm run debug
   

3. Cursor IDE で MCP ツールを使用します：

   connectToBrowser: { "debugPort": 9222, "structurizrPort": 8080 }
   getDslErrors: { "count": 5 }
   clearDslErrors: {}
   fixDslError: { "line": 776, "fix": "dynamic ContainerName ErrorHandlingFlow {" }
   

簡易版

メインのデバッガーで問題が発生した場合は、簡易版をお試しください：

node simplified-dsl-debugger.js

MCP ツール名が短いバージョン：

connect: { "port": 9222 }
errors: { "count": 5 }
fix: { "line": 776, "solution": "dynamic ContainerName ErrorHandlingFlow {" }

ユーティリティスクリプト

• エラーを直接取得：

  npm run capture
  

• 取得したエラーを表示：

  npm run errors
  

トラブルシューティング

Chrome の接続に関する問題

• リモートデバッグを有効にして、ポート 9222 で Chrome が実行されていることを確認してください
• --remote-debugging-port フラグを指定して Chrome がすでに実行されているか確認してください
• 次のコマンドで Chrome を再起動してみてください：google-chrome --remote-debugging-port=9222 http://localhost:8080

MCP ツールに関する問題

• MCP サーバーが実行されていることを確認してください：npm start
• 簡易版を試してください：node simplified-dsl-debugger.js
• 取得したエラーがログディレクトリにあるか確認してください
• Cursor IDE を再起動してください

ポートの競合

• Structurizr のデフォルトポートは 8080 です
• 別のアプリケーションがポート 8080 を使用している場合は、次の方法があります：
  • Structurizr のポートを変更する
  • 新しいポートを使用するようデバッガーを更新する：STRUCTURIZR_PORT=9090 npm start

ライセンス

MIT