Structurizr DSL Debug MCP

🚀 用於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許可證協議。