Structurizr DSL Debug MCP

🚀 用于Cursor的Structurizr DSL调试器

这是一款专门为Cursor IDE量身打造的工具，旨在解决Structurizr DSL语法调试难题。它借助Model Context Protocol（MCP）与Cursor深度集成，能够实时检测、分析Structurizr DSL中的错误，并提供修复建议。

🚀 快速开始

本调试器可助力开发者在Cursor IDE中高效调试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

若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许可证协议。