Structurizr-DSL-Debug-MCP

# Structurizr DSL Debugger for Cursor A specialized tool for debugging Structurizr DSL syntax issues in Cursor IDE. This tool integrates with Cursor using the Model Context Protocol (MCP) to provide real-time Structurizr DSL error detection, analysis, and fix suggestions. ## Features - 🔍 **Real-time error detection** - Automatically captures syntax errors from Structurizr DSL files - 🛠️ **Suggested fixes** - Provides intelligent suggestions to correct common DSL errors - 🔄 **Browser integration** - Connects to Chrome with Structurizr pages to monitor errors - 🧩 **Cursor IDE integration** - Seamlessly integrates with Cursor using MCP tools - ⚙️ **Configurable** - Support for custom Structurizr port configuration - 📊 **Error history** - Maintains logs of captured errors for review ## Requirements - Node.js 14+ - Cursor IDE - Google Chrome with remote debugging enabled - Structurizr Lite running locally (typically on port 8080) ## Installation 1. Clone this repository: ```bash git clone https://github.com/your-username/structurizr-dsl-debugger.git cd structurizr-dsl-debugger ``` 2. Install dependencies: ```bash npm install ``` 3. Set up Cursor IDE integration: ```bash npm run setup ``` ## Usage ### Starting Structurizr 1. Run Structurizr Lite (if not already running): ```bash docker run -it --rm -p 8080:8080 -v /path/to/workspace:/workspace structurizr/lite ``` ### Using the Debugger 1. Launch Chrome with remote debugging enabled: ```bash google-chrome --remote-debugging-port=9222 http://localhost:8080 ``` 2. Start the DSL debugger: ```bash # 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. In Cursor IDE, use the MCP tools: ``` connectToBrowser: { "debugPort": 9222, "structurizrPort": 8080 } getDslErrors: { "count": 5 } clearDslErrors: {} fixDslError: { "line": 776, "fix": "dynamic ContainerName ErrorHandlingFlow {" } ``` ### Simplified Version If you encounter issues with the main debugger, try the simplified version: ```bash node simplified-dsl-debugger.js ``` With shorter MCP tool names: ``` connect: { "port": 9222 } errors: { "count": 5 } fix: { "line": 776, "solution": "dynamic ContainerName ErrorHandlingFlow {" } ``` ### Utility Scripts - **Capture errors directly**: ```bash npm run capture ``` - **View captured errors**: ```bash npm run errors ``` ## Troubleshooting ### Chrome Connection Issues - Ensure Chrome is running with remote debugging enabled on port 9222 - Check if Chrome is already running with the `--remote-debugging-port` flag - Try restarting Chrome with: `google-chrome --remote-debugging-port=9222 http://localhost:8080` ### MCP Tool Issues - Verify the MCP server is running: `npm start` - Try using the simplified version: `node simplified-dsl-debugger.js` - Check the logs directory for captured errors - Restart Cursor IDE ### Port Conflicts - Structurizr default port is 8080 - If another application is using port 8080, you can: - Change the Structurizr port - Update the debugger to use the new port: `STRUCTURIZR_PORT=9090 npm start` ## License MIT