Structurizr DSL Debugger for Cursor

by ViperJuice

3 stars

344 downloads

Not rated

GitHub

Developer Tools

About

Mcp server to connect to structurizer dsl rendered in the browser and return error messages regarding parsing to Cursor IDE

Details

Author: ViperJuice
GitHub stars: 3
Downloads: 344
Categories: Developer Tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Structurizr DSL Debugger for Cursor

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

From the repository

Install dependencies via npm install and run npm run setup for Cursor integration. Start Structurizr Lite (e.g., Docker), launch Chrome with remote debugging (--remote-debugging-port=9222), then start the debugger with npm start (or with custom port via STRUCTURIZR_PORT). In Cursor, use MCP tools like connectToBrowser, getDslErrors, clearDslErrors, and fixDslError. A simplified version is available via node simplified-dsl-debugger.js with shorter tool names.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "structurizr dsl debugger for cursor": {
            "Structurizr-DSL-Debug-MCP": {
                "command": "docker",
                "args": [
                    "run",
                    "-it",
                    "--rm",
                    "-p",
                    "8080:8080",
                    "-v",
                    "/path/to/workspace:/workspace",
                    "structurizr/lite"
                ]
            }
        }
    }
}

McpServers

{
    "Structurizr-DSL-Debug-MCP": {
        "command": "docker",
        "args": [
            "run",
            "-it",
            "--rm",
            "-p",
            "8080:8080",
            "-v",
            "/path/to/workspace:/workspace",
            "structurizr/lite"
        ]
    }
}

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:

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

   cd structurizr-dsl-debugger

2. Install dependencies:

   npm install

3. Set up Cursor IDE integration:

   npm run setup

Usage

Starting Structurizr

1. Run Structurizr Lite (if not already running):

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

Using the Debugger

1. Launch Chrome with remote debugging enabled:

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

2. Start the DSL debugger:

   # 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:

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:

  npm run capture

- View captured errors:

  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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Structurizr DSL Debugger for Cursor

Features

Requirements

Installation

Usage

Starting Structurizr

Using the Debugger

Simplified Version

Utility Scripts

Troubleshooting

Chrome Connection Issues

MCP Tool Issues

Port Conflicts

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright