Structurizr DSL Debugger for Cursor

Cursor 的 Structurizr DSL 调试器

用于在 Cursor IDE 中调试 Structurizr DSL 语法问题的专用工具。该工具通过模型上下文协议（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 连接问题

• 确保 Chrome 已运行，并在端口 9222 上启用远程调试
• 检查 Chrome 是否已使用 --remote-debugging-port 标志运行
• 尝试使用以下命令重启 Chrome：google-chrome --remote-debugging-port=9222 http://localhost:8080

MCP 工具问题

• 确认 MCP 服务正在运行：npm start
• 尝试使用简化版：node simplified-dsl-debugger.js
• 检查 logs 目录中是否有捕获的错误
• 重启 Cursor IDE

端口冲突

• Structurizr 的默认端口是 8080
• 如果其他应用正在使用端口 8080，你可以：
  • 更改 Structurizr 端口
  • 更新调试器以使用新端口：STRUCTURIZR_PORT=9090 npm start

许可证

MIT