https://github.com/cat-state/nrepl-mcp
simple MCP server for nREPL
https://github.com/cat-state/nrepl-mcp
Last synced: 7 months ago
JSON representation
simple MCP server for nREPL
- Host: GitHub
- URL: https://github.com/cat-state/nrepl-mcp
- Owner: cat-state
- Created: 2025-03-07T05:47:05.000Z (7 months ago)
- Default Branch: master
- Last Pushed: 2025-03-07T05:55:38.000Z (7 months ago)
- Last Synced: 2025-03-07T06:28:33.045Z (7 months ago)
- Language: Python
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **nrepl-mcp** - simple MCP server for nREPL `python` `mcp` `server` `pip install git+https://github.com/cat-state/nrepl-mcp` (AI/ML)
- awesome-mcp-servers - **nrepl-mcp** - simple MCP server for nREPL `python` `mcp` `server` `pip install git+https://github.com/cat-state/nrepl-mcp` (AI/ML)
README
# Basilisp nREPL MCP Bridge
This project provides a bridge between Anthropic's Model Control Protocol (MCP) and Basilisp's nREPL server, allowing Claude Code to interact directly with a Basilisp REPL.
Actually, it should work with any nREPL, but the current prompts are Basilisp focused.
## Features
- Execute code and receive pretty-printed, syntax-highlighted results
- Get documentation for symbols
- List all available namespaces
- Find all variables in a namespace
- Check nREPL server connectivity
- Basilisp: Python interop with proper syntax for attribute access and method calls
- Enhanced error reporting and formatting
## Requirements
- uv
- [basilisp](https://github.com/basilisp-lang/basilisp)
## Usage
1. Start a Basilisp nREPL server:
```
basilisp nrepl-server --port 36915
```
2. Add the MCP bridge to Claude Code:
```
claude mcp add /home/a/subjective/snr/basilisp_mcp_bridge.py
```
3. Connect with Claude and use the available tools:
- `eval_code(code)` - Evaluate Basilisp code
- `get_docs(symbol)` - Get documentation for a symbol
- `find_namespace_vars(namespace)` - List variables in a namespace
- `list_namespaces()` - List all available namespaces
- `check_connection()` - Verify nREPL connectivity
## Python Interop Examples
```clojure
;; Import a module
(import [math :as math])
;; Access an attribute
(. math -pi) ;; or (.-pi math)
;; Call a method
(.sin math 0)
;; Create Python data structures
#py{"key" "value"}
```
## Future Improvements
- Implement a proper bencode parser (beyond regex)
- Add session management for multiple REPLs
- Add auto-completion support