Clojure MCP
a year ago
- #Open Source
- #Clojure
- #AI Development
- Alpha Software - Work in Progress: The project is in early development, with breaking changes and incomplete documentation expected.
- Help Wanted: Contributions are encouraged, including bug reports, feature suggestions, pull requests, and documentation improvements.
- Clojure MCP Server: Implements a Model Context Protocol (MCP) server for Clojure, connecting AI models to a Clojure nREPL for enhanced development.
- Features: Includes Clojure REPL connection, Clojure-aware editing tools, and Emacs edit highlighting (alpha).
- Development Approach: Emphasizes immediate feedback, incremental development, human oversight, and a functional approach.
- Requirements: Clojure 1.11 or later, Java JDK 11 or later, and Claude Desktop for the best experience.
- Installation: Clone the repository or use as a git dependency in deps.edn.
- Configuration: Add MCP server configuration to deps.edn and update Claude Desktop configuration file.
- Workflow: Start nREPL in the target project, restart Claude Desktop, and verify the connection.
- LLM Interaction: Use the REPL for immediate feedback, iterative design, and validation of solutions.
- Project Summary: Maintain an LLM-friendly PROJECT_SUMMARY.md for quick codebase understanding.
- API Keys: Required for agent tools from providers like Google Gemini, OpenAI, and Anthropic.
- Customization: The MCP server is modular, allowing for custom tools, resources, and prompts.
- Security: Configure allowed directories in .clojure-mcp/config.edn to control file access.
- Best Practices: Develop in small steps, validate frequently, and maintain human oversight.
- License: GNU Affero General Public License v3.0, ensuring open-source contributions and preventing commercial exploitation without sharing improvements.