Shadow CLJS Build Monitor

🚀 shadow-cljs-mcp

A Model Context Protocol (MCP) server that monitors shadow-cljs builds and provides real-time build status updates.

🚀 Quick Start

This MCP server connects to a running shadow-cljs instance, tracks build progress, failures, and completion status. It provides an MCP tool for the LLM to verify the build status after making modifications to ClojureScript files.

✨ Features

• Tracks build progress, failures, and completion status of shadow-cljs.
• Provides real-time build status updates.
• Verifies build status for LLM after modifying ClojureScript files.

📦 Installation

Add the following content to your settings in Cline/Cursor/Claude, etc.:

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

Configuration with an optional server location:

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

The --host and --port parameters are optional. If not provided, the default server will connect to localhost:9630.

💻 Usage Examples

Basic Usage

Add to Your LLM Notes

Add the following content to your LLM notes file (e.g., CLAUDE.md, cursorrules.md):

After any edits to ClojureScript files, use the get_last_build_status tool of the shadow-cljs-mcp server to verify if the build was successful:

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

This operation will display:
- Build status (completed/failed)
- Compiled files
- Any errors or warnings
- Build duration and metrics

Advanced Usage

Example Tool Responses

Successful build:

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

Failed build:

{
  "status": "failed",
  "message": "Build failed",
  "details": {
    // Error information
  }
}

📚 Documentation

LLM Integration

Add the relevant configuration and usage steps to your LLM notes to integrate the shadow-cljs-mcp server.

Usage Precautions

• The LLM should call get_last_build_status after each edit to ClojureScript files.
• Compilation errors will be displayed in detail for easy debugging.
• A successful build shows the compiled files and the time taken.
• Ensure that shadow-cljs is running before starting this server.

Prerequisites

• A running shadow-cljs instance (connects to localhost:9630 by default, unless otherwise configured)