Shadow Cljs MCP

🚀 陰影.cljs - MCP

一個模型上下文協議（MCP）服務器，用於監視 shadow-cljs 構建並提供即時構建狀態更新，為開發者在 ClojureScript 開發過程中提供便利，能及時獲取構建狀態。

🚀 快速開始

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

📦 安裝指南

在你的 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。

💻 使用示例

基礎用法

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）