|
1 | 1 | # Clojure MCP: REPL-Driven Development with AI Assistance |
2 | 2 |
|
3 | | -> **⚠️ Alpha Software - Work in Progress** |
4 | | -
|
5 | 3 | Clojure MCP connects AI models to your Clojure development |
6 | 4 | environment, enabling a remarkable REPL-driven development experience |
7 | 5 | powered by large language models (LLMs). |
8 | 6 |
|
| 7 | +## IMPORTANT UPDATE |
| 8 | + |
| 9 | +**Status Update (November 14 2025)**: Recent improvements in Claude Code with Sonnet 4.5 have significantly changed the landscape for AI-assisted Clojure development. This model makes far fewer editing errors and coding logic errors than previous models, reducing the need for specialized clj-rewrite-based editing tools and REPL validation that ClojureMCP was designed to provide. |
| 10 | + |
| 11 | +**Recommended Starting Point** |
| 12 | + |
| 13 | +**For new users**: I recommend starting with [Claude Code](https://www.claude.com/product/claude-code) paired with [clojure-mcp-light](https://github.com/bhauman/clojure-mcp-light), which provides: |
| 14 | +- Automatic correction of occasional delimiter errors |
| 15 | +- nREPL CLI connection script |
| 16 | +- Performance statistics tracking |
| 17 | + |
| 18 | +This is my current daily driver and has significantly improved my productivity compared to using Claude Desktop with the full ClojureMCP toolset. |
| 19 | + |
| 20 | +**When to Use Full ClojureMCP** |
| 21 | + |
| 22 | +ClojureMCP remains valuable for: |
| 23 | +- **Other LLM models** - Models with weaker editing capabilities benefit from the advanced tooling |
| 24 | +- **Desktop environments** - Use with Claude Desktop to see visible tool execution chains and reasoning |
| 25 | +- **Custom assistants** - Building your own code assistance tools |
| 26 | +- **Complete control** - When you need the full suite of Clojure-aware tools |
| 27 | +- **Portable LLM tooling configuration** ClojureMCP provides a portable |
| 28 | + toolset include custom agents, prompts, etc that you can use with any LLM that supports MCP |
| 29 | + |
| 30 | +**Future Direction** |
| 31 | + |
| 32 | +I'll continue developing ClojureMCP, but will be using Claude Code with clojure-mcp-light for the development work itself. ClojureMCP remains the comprehensive toolkit for Clojure AI assistance across any LLM. |
| 33 | + |
9 | 34 | ## 🚀 Quick Overview |
10 | 35 |
|
11 | 36 | Clojure MCP transforms LLMs into: |
|
0 commit comments