{"_id":"shadow-cljs-mcp","_rev":"4-5cc8fd98015fa5d4d34e89bb9164248a","name":"shadow-cljs-mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"shadow-cljs-mcp","version":"0.1.0","keywords":["mcp","shadow-cljs","model-context-protocol","clojurescript","build-monitor"],"author":{"name":"ModelContextProtocol"},"license":"MIT","_id":"shadow-cljs-mcp@0.1.0","maintainers":[{"name":"bigsy","email":"bill.hedworth@gmail.com"}],"homepage":"https://github.com/Bigsy/shadow-cljs-mcp#readme","bugs":{"url":"https://github.com/Bigsy/shadow-cljs-mcp/issues"},"bin":{"shadow-cljs-mcp":"index.js"},"dist":{"shasum":"05a19f149fc533918851dd0d34f96aa2fef3cc69","tarball":"https://registry.npmjs.org/shadow-cljs-mcp/-/shadow-cljs-mcp-0.1.0.tgz","fileCount":3,"integrity":"sha512-zrWcVEd3xN7miohVWHfKPqPf9bxlN1FglweweVkpbxP2jHVTl4kFuDoJ6k6OGeAkAQ/774vCnHe0uXKdBlzLWg==","signatures":[{"sig":"MEUCIQDiDxk5/fhiwaEPhwn8SoqSckiLf0Wn1svbpjzdP5CDTwIgD7533KjZVfmuzP+tSu94EWpyuYeYN3vcv8YSeGXYKUk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10114},"main":"index.js","type":"module","engines":{"node":">=14"},"gitHead":"58a17d5c330357d7d961822414a10b0b9426789e","scripts":{"test":"echo \"No tests specified\" && exit 0","start":"node index.js","publish":"npm publish --access public","prepublishOnly":"npm test"},"_npmUser":{"name":"bigsy","email":"bill.hedworth@gmail.com"},"repository":{"url":"git+https://github.com/Bigsy/shadow-cljs-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol server for monitoring shadow-cljs builds","directories":{},"_nodeVersion":"23.7.0","dependencies":{"ws":"^8.18.1","node-fetch":"^3.3.2","transit-js":"^0.8.874","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.0.0","@types/node":"^18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/shadow-cljs-mcp_0.1.0_1744570898050_0.8505200259583752","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"shadow-cljs-mcp","version":"0.1.1","keywords":["mcp","shadow-cljs","model-context-protocol","clojurescript","build-monitor"],"author":{"name":"ModelContextProtocol"},"license":"MIT","_id":"shadow-cljs-mcp@0.1.1","maintainers":[{"name":"bigsy","email":"bill.hedworth@gmail.com"}],"homepage":"https://github.com/Bigsy/shadow-cljs-mcp#readme","bugs":{"url":"https://github.com/Bigsy/shadow-cljs-mcp/issues"},"bin":{"shadow-cljs-mcp":"index.js"},"dist":{"shasum":"2d4fdd676c89c46c4c4f214d75639405d6845ffd","tarball":"https://registry.npmjs.org/shadow-cljs-mcp/-/shadow-cljs-mcp-0.1.1.tgz","fileCount":3,"integrity":"sha512-D5ZpOcPo4zU2oz1zLR4FtZ7N/dRk18BARDKKrqGWm7qPK9HwXDNrq3+LO7eeVss4yyiUzeS8ohfaWTHxbqSu/w==","signatures":[{"sig":"MEUCIQCj9Z1YLl+RdVkckzIvX3/7ZIjNmWcDNfVQ9W9sd8q2BQIgVrIbyP+xcVars8OKtJVdkLaQ8Dai3ygWcV1Z5n9Q+vA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":10114},"main":"index.js","type":"module","engines":{"node":">=14"},"gitHead":"58a17d5c330357d7d961822414a10b0b9426789e","scripts":{"test":"echo \"No tests specified\" && exit 0","start":"node index.js","publish":"npm publish --access public","prepublishOnly":"npm test"},"_npmUser":{"name":"bigsy","email":"bill.hedworth@gmail.com"},"repository":{"url":"git+https://github.com/Bigsy/shadow-cljs-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol server for monitoring shadow-cljs builds","directories":{},"_nodeVersion":"23.7.0","dependencies":{"ws":"^8.18.1","node-fetch":"^3.3.2","transit-js":"^0.8.874","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.0.0","@types/node":"^18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/shadow-cljs-mcp_0.1.1_1744570965374_0.4860701666912566","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"shadow-cljs-mcp","version":"0.1.2","keywords":["mcp","shadow-cljs","model-context-protocol","clojurescript","build-monitor"],"author":{"name":"ModelContextProtocol"},"license":"MIT","_id":"shadow-cljs-mcp@0.1.2","maintainers":[{"name":"bigsy","email":"bill.hedworth@gmail.com"}],"homepage":"https://github.com/Bigsy/shadow-cljs-mcp#readme","bugs":{"url":"https://github.com/Bigsy/shadow-cljs-mcp/issues"},"bin":{"shadow-cljs-mcp":"index.js"},"dist":{"shasum":"835747ff7a4edb2284da9d7390e075dacf30aa54","tarball":"https://registry.npmjs.org/shadow-cljs-mcp/-/shadow-cljs-mcp-0.1.2.tgz","fileCount":4,"integrity":"sha512-H1IopNK5FjQoUbPI2RfZ9kEv5Ua/V+whk/veHUnTiFBjBxxDr/rJsttiS35GTX9Hkg7sHe39HxnHlyhHLRByng==","signatures":[{"sig":"MEQCIE7ekKXJr4CduzUoRruTMB9CJg/pesi2Qyz4hIi2oh0MAiAn33eN/803A/IdTdJJYHf9S5iQZG6IxVKfa4yeNWzOEA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12247},"main":"index.js","type":"module","engines":{"node":">=14"},"gitHead":"87bd7cc2f2d8f210b19a34f09548b35410d00a4d","scripts":{"test":"echo \"No tests specified\" && exit 0","start":"node index.js","publish":"npm publish --access public","prepublishOnly":"npm test"},"_npmUser":{"name":"bigsy","email":"bill.hedworth@gmail.com"},"repository":{"url":"git+https://github.com/Bigsy/shadow-cljs-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A Model Context Protocol server for monitoring shadow-cljs builds","directories":{},"_nodeVersion":"23.7.0","dependencies":{"ws":"^8.18.1","node-fetch":"^3.3.2","transit-js":"^0.8.874","@modelcontextprotocol/sdk":"^1.8.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.0.0","@types/node":"^18.0.0"},"_npmOperationalInternal":{"tmp":"tmp/shadow-cljs-mcp_0.1.2_1744652963525_0.09707175311192962","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"shadow-cljs-mcp","version":"0.1.3","description":"A Model Context Protocol server for monitoring shadow-cljs builds","main":"index.js","type":"module","bin":{"shadow-cljs-mcp":"index.js"},"scripts":{"start":"node index.js","prepublishOnly":"npm test","test":"echo \"No tests specified\" && exit 0","publish":"npm publish --access public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.8.0","ws":"^8.18.1","transit-js":"^0.8.874","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^18.0.0","@types/ws":"^8.0.0"},"keywords":["mcp","shadow-cljs","model-context-protocol","clojurescript","build-monitor"],"author":{"name":"ModelContextProtocol"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Bigsy/shadow-cljs-mcp.git"},"engines":{"node":">=14"},"_id":"shadow-cljs-mcp@0.1.3","gitHead":"bed34d7eb0056e2eceaf7b8bebbaec521e63744d","bugs":{"url":"https://github.com/Bigsy/shadow-cljs-mcp/issues"},"homepage":"https://github.com/Bigsy/shadow-cljs-mcp#readme","_nodeVersion":"23.7.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-H4oS2ZPAuXmvJOu0tTOH4IkZjkGc+YomcEbrv3ObcEDxnpgInFgQX1X0Eb9uQwJFhJAnxc74xfFBaxDGizOkRA==","shasum":"0ea4d2ef72299475f3aa3428e8221c7128f53633","tarball":"https://registry.npmjs.org/shadow-cljs-mcp/-/shadow-cljs-mcp-0.1.3.tgz","fileCount":4,"unpackedSize":14249,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDypF58rKCFJbihbwQiNgfn9fsMOmH0Q/GDZZj3WR2yEwIgOG2IzTIadM5nxxN4YJJO2PWhydukeffCOGvTwK7Phlw="}]},"_npmUser":{"name":"bigsy","email":"bill.hedworth@gmail.com"},"directories":{},"maintainers":[{"name":"bigsy","email":"bill.hedworth@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/shadow-cljs-mcp_0.1.3_1744746374846_0.5151746192888988"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-13T19:01:38.049Z","modified":"2025-04-15T19:46:15.186Z","0.1.0":"2025-04-13T19:01:38.236Z","0.1.1":"2025-04-13T19:02:45.533Z","0.1.2":"2025-04-14T17:49:23.707Z","0.1.3":"2025-04-15T19:46:15.027Z"},"bugs":{"url":"https://github.com/Bigsy/shadow-cljs-mcp/issues"},"author":{"name":"ModelContextProtocol"},"license":"MIT","homepage":"https://github.com/Bigsy/shadow-cljs-mcp#readme","keywords":["mcp","shadow-cljs","model-context-protocol","clojurescript","build-monitor"],"repository":{"type":"git","url":"git+https://github.com/Bigsy/shadow-cljs-mcp.git"},"description":"A Model Context Protocol server for monitoring shadow-cljs builds","maintainers":[{"name":"bigsy","email":"bill.hedworth@gmail.com"}],"readme":"# shadow-cljs-mcp\n\n[![npm version](https://badge.fury.io/js/shadow-cljs-mcp.svg)](https://badge.fury.io/js/shadow-cljs-mcp)\n\nA Model Context Protocol (MCP) server that monitors shadow-cljs builds and provides real-time build status updates.\n\n## Installation\n\nAdd the following to your Cline/Cursor/Claude whatever settings:\n```json\n{\n  \"mcpServers\": {\n    \"shadow-cljs-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"shadow-cljs-mcp\"\n      ],\n      \"disabled\": false,\n      \"autoApprove\": [],\n      \"timeout\": 60\n    }\n  }\n}\n```\nWith optional server location\n```json\n{\n  \"mcpServers\": {\n    \"shadow-cljs-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"shadow-cljs-mcp\",\n        \"--host\",\n        \"localhost\",\n        \"--port\",\n        \"9630\"\n      ],\n      \"disabled\": false,\n      \"autoApprove\": [],\n      \"timeout\": 60\n    }\n  }\n}\n```\n\nThe `--host` and `--port` arguments are optional. If not provided, the server will default to connecting to `localhost:9630`.\n\n## Overview\n\nThis 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.\n\n## LLM Integration\n\n### Adding to Your LLM Notes\n\nAdd the following to your LLM's notes file (e.g., CLAUDE.md, cursorrules.md):\n\n```markdown\nAfter any edits to ClojureScript files, use the shadow-cljs-mcp server's get_last_build_status tool to verify the build succeeded:\n\n<use_mcp_tool>\n<server_name>shadow-cljs-mcp</server_name>\n<tool_name>get_last_build_status</tool_name>\n<arguments>\n{}\n</arguments>\n</use_mcp_tool>\n\nThis will show:\n- Build status (completed/failed)\n- Which files were compiled\n- Any errors or warnings\n- Build duration and metrics\n```\n\n## Example Tool Response\n\nSuccessful build:\n```json\n{\n  \"status\": \"completed\",\n  \"resources\": 317,\n  \"compiled\": 1,\n  \"warnings\": 0,\n  \"duration\": 0.609,\n  \"compiledFiles\": [\n    \"path/to/your/file.cljs (505ms)\"\n  ]\n}\n```\n\nFailed build:\n```json\n{\n  \"status\": \"failed\",\n  \"message\": \"Build failed\",\n  \"details\": {\n    // Error information\n  }\n}\n```\n\n## Usage Notes\n\n- LLMs should call get_last_build_status after each ClojureScript file edit\n- Compilation errors will be shown in detail for easy debugging\n- Successful builds show which files were compiled and how long they took\n- Make sure shadow-cljs is running before starting this server\n\n## Requirements\n- Running shadow-cljs instance (defaults to localhost:9630 if not configured otherwise)\n","readmeFilename":"README.md"}