Shadow CLJS Build Monitor

🚀 shadow-cljs-mcp

shadow-cljs-mcp是一個模型上下文協議（MCP）服務器，用於監控shadow-cljs構建，並即時提供構建狀態更新，助力開發者及時掌握構建情況。

🚀 快速開始

shadow-cljs-mcp可幫助您監控shadow-cljs構建並獲取即時狀態更新。以下是使用前的安裝和配置步驟。

📦 安裝指南

在您的Cline/Cursor/Claude等設置中添加以下內容：

{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}

若您需要配置可選的服務器位置，可以使用以下配置：

{
  "mcpServers": {
    "shadow-cljs-mcp": {
      "command": "npx",
      "args": [
        "shadow-cljs-mcp",
        "--host",
        "localhost",
        "--port",
        "9630"
      ],
      "disabled": false,
      "autoApprove": [],
      "timeout": 60
    }
  }
}

注意：--host和--port參數是可選的。如果未提供，默認服務器將連接到localhost:9630。

📚 詳細文檔

概述

此MCP服務器會連接到運行中的shadow-cljs實例，對構建進度、失敗和完成狀態進行跟蹤。它為LLM提供一個MCP工具，可在對ClojureScript文件進行修改後驗證構建狀態。

LLM集成

添加到您的LLM筆記中

將以下內容添加到您的LLM筆記文件中（例如CLAUDE.md、cursorrules.md）：

在任何編輯ClojureScript文件之後，請使用shadow-cljs-mcp服務器的get_last_build_status工具驗證構建是否成功：

<use_mcp_tool>
<server_name>shadow-cljs-mcp</server_name>
<tool_name>get_last_build_status</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>

此操作將顯示：
- 構建狀態（完成/失敗）
- 編譯的文件
- 任何錯誤或警告
- 構建持續時間和指標

示例工具響應

成功構建

{
  "status": "completed",
  "resources": 317,
  "compiled": 1,
  "warnings": 0,
  "duration": 0.609,
  "compiledFiles": [
    "path/to/your/file.cljs (505ms)"
  ]
}

失敗構建

{
  "status": "failed",
  "message": "Build failed",
  "details": {
    // 錯誤信息
  }
}

使用注意事項

⚠️ 重要提示

• LLM應在每次編輯ClojureScript文件後調用get_last_build_status。
• 編譯錯誤將以詳細方式顯示，便於調試。
• 成功構建會顯示編譯的文件及其所用時間。
• 確保在啟動此服務器之前shadow-cljs正在運行。

前提條件

• 運行中的shadow-cljs實例（默認連接到localhost:9630，除非另有配置）