🚀 用于Cursor的Structurizr DSL调试器

这是一个专门为在Cursor IDE中调试Structurizr DSL语法问题而设计的工具。它借助Model Context Protocol（MCP）与Cursor集成，能够实现实时的Structurizr DSL错误检测、分析，并提供修复建议。

🚀 快速开始

此工具可帮助你在Cursor IDE中高效调试Structurizr DSL语法问题，通过MCP与Cursor集成，实现实时错误检测与修复。

✨ 主要特性

• 🔍 实时错误检测：自动捕获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

运行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
   
   # 使用带有交互式提示的launcher
   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许可证协议。