shadow-cljs-mcp

Integrations

  • Monitors shadow-cljs builds and provides real-time build status updates for ClojureScript files, including compilation success/failure status, compiled files, error details, and build metrics.

  • Connects to a running shadow-cljs instance to track build progress and enable verification of build status after code changes through the npm package shadow-cljs-mcp.

shadow-cljs-mcp

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

Installation

Add the following to your Cline/Cursor/Claude whatever settings:

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

With 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 arguments are optional. If not provided, the server will default to connecting to localhost:9630.

Overview

This MCP server connects to a running shadow-cljs instance and tracks build progress, failures, and completions. It provides an MCP tool that LLMs can use to verify build status after making changes to ClojureScript files.

LLM Integration

Adding to Your LLM Notes

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

After any edits to ClojureScript files, use the shadow-cljs-mcp server's get_last_build_status tool to verify the build succeeded: <use_mcp_tool> <server_name>shadow-cljs-mcp</server_name> <tool_name>get_last_build_status</tool_name> <arguments> {} </arguments> </use_mcp_tool> This will show: - Build status (completed/failed) - Which files were compiled - Any errors or warnings - Build duration and metrics

Example Tool Response

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 } }

Usage Notes

  • LLMs should call get_last_build_status after each ClojureScript file edit
  • Compilation errors will be shown in detail for easy debugging
  • Successful builds show which files were compiled and how long they took
  • Make sure shadow-cljs is running before starting this server

Requirements

  • Running shadow-cljs instance (defaults to localhost:9630 if not configured otherwise)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that monitors shadow-cljs builds and provides real-time build status updates for ClojureScript projects, allowing LLMs to verify build status after making code changes.

  1. Installation
    1. Overview
      1. LLM Integration
        1. Adding to Your LLM Notes
      2. Example Tool Response
        1. Usage Notes
          1. Requirements

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              An unofficial JavaScript SDK to create customized servers for the Model Context Protocol, allowing definition of prompts, resources, and tools for tailored interactions.
              Last updated -
              6
              2
              JavaScript
              Apache 2.0
              • Linux
              • Apple
            • A
              security
              F
              license
              A
              quality
              Enables interaction with a running Clojure nREPL instance for evaluating Clojure code, inspecting namespaces, and retrieving connection statuses, compatible with MCP clients like Claude Desktop and CLine in VSCode.
              Last updated -
              3
              9
              16
              JavaScript
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol Server that enables LLMs to interact with and execute REST API calls through natural language prompts, supporting GET/PUT/POST/PATCH operations on configured APIs.
              Last updated -
              5
              Python
              Apache 2.0
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that provides clj-kondo linting capabilities for Clojure/ClojureScript/EDN files, useful for environments like Claude code and desktop that lack built-in linting.
              Last updated -
              236
              1
              JavaScript
              MIT License

            View all related MCP servers

            ID: jt9369ijhn