Structurizr DSL Debug MCP

🚀 用于CursorのStructurizr DSLデバッガー

このツールは、Cursor IDE内でStructurizr DSLの構文問題をデバッグするために特別に設計されています。Model Context Protocol（MCP）を通じてCursorと統合し、リアルタイムでStructurizr DSLのエラー検出、分析、および修正提案を行います。

✨ 主な機能

• 🔍 リアルタイムエラー検出 - Structurizr DSLファイル内の構文エラーを自動的に検出します。
• 🛠️ 修正提案 - 一般的なDSLエラーを修正するためのインテリジェントな提案を提供します。
• 🔄 ブラウザ統合 - Chromeに接続し、Structurizrページを開いてエラーを監視します。
• 🧩 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デバッガーを起動します：

   # 標準起動（デフォルトポート8080）
   npm start
   
   # カスタムのStructurizrポートを使用
   STRUCTURIZR_PORT=9090 npm start
   
   # 対話型プロンプト付きの起動ツールを使用
   npm run debug
   

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

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

簡易版の使用

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

node simplified-dsl-debugger.js

より短いMCPツール名を使用します：

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

ツールスクリプト

• エラーを直接キャプチャする：

  npm run capture
  

• キャプチャされたエラーを表示する：

  npm run errors
  

📚 ドキュメント

トラブルシューティング

Chromeブラウザの接続問題

• Chromeが実行されており、リモートデバッグ機能が9222ポートで有効になっていることを確認してください。
• 他のプログラムがリモートデバッグポートを使用していないことを確認してください。
• Chromeブラウザを再起動してみてください：

  chrome --remote-debugging-port=9222
  

MCPツールの問題

• MCP接続が失敗した場合は、ターゲットプロセスが実行されており、リモートデバッグ要求を受け入れるように設定されていることを確認してください。

ポート競合の問題

• 指定されたポート（例：8080または9222）を他のプログラムが使用していないことを確認してください。
• 異なるポートを使用して設定と接続を試してみてください。

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています。