Clojure nREPL

by johancodinha

29 stars

436 downloads

Not rated

GitHub

About

Integrates with Clojure nREPL instances to enable code evaluation, namespace listing, and public var inspection for AI-assisted Clojure development.

Details

Author: johancodinha
Repository: JohanCodinha/nrepl-mcp-server
GitHub stars: 29
Downloads: 436
Categories: Developer Tools, Productivity, Design, AI, Infrastructure, Frontend
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Clojure nREPL

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

Installing In Cline Vscode Or Claude Desktop

To use this server withCLineorClaude Desktop, follow these steps:
- OpenCLinein VSCode orClaude Desktop.
- Navigate to theMCP Settings.
- Add a new MCP server with the following configuration:

{ "mcpServers": { "nrepl-mcp-server": { "command": "npx", "args": ](https://github.com/modelcontextprotocol)[ "nrepl-mcp-server" ], "disabled": false, "autoApprove": [] } } }

This will allow the client to communicate with the nREPL MCP server via standard input/output.

To quickly run the server without cloning the repository:
- Clone the repository
- Install dependencies

npm install

- Production Mode: Runs from compiled output.

npm start

- Development Mode: Uses ts-node for live changes.

This starts the server, listening onSTDIOfor MCP requests. Mcp client will start the server for you.

Allows establishing a connection to an nREPL server by specifying ahostandport.

Executes arbitrary Clojure expressions in either thedefault namespaceor aspecified namespace.

Lists all namespaces in the current project directory usingtools.namespace.

Fetches metadata and current values for allpublic varsin a specified namespace.

Provides details on the current nREPL connection, including host, port, session ID, and last error (if any).

Provides information about the current nREPL connection, including:

- Host and port
- Connection status
- Active session ID

Lists all namespaces detected in the project directory.

Contributions are welcome! If you have feature suggestions or bug reports, please open an issue or pull request.

This project is licensed under theMIT License. Feel free to modify and distribute according to its terms.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.

Official Context7 MCP server that brings up-to-date, version-specific library documentation and code examples into AI coding prompts.

Remote, no-auth MCP server providing AI-powered codebase context and answers

Instead of direct calling MCP tools, mcpcode server transforms MCP tool calls into TypeScript programs, enabling smarter, lower-latency orchestration by LLMs.

Help agents automatically write and test stories for your UI components

Official Svelte MCP server, provides docs and suggestions on the generated code.

Supercharge your Agent with Semantic Code Intelligence and save 💰 in the process!

Execute any LLM-generated code in the YepCode secure and scalable sandbox environment and create your own MCP tools using JavaScript or Python, with full support for NPM and PyPI packages

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "clojure nrepl": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Interact with a running Clojure nREPL instance for code evaluation, namespace inspection, and other utilities.

AModel Context Protocol (MCP)server designed for MCP clients, such asClaude DesktoporCLinein VSCode. This server can be used with any LLM when used with CLine. This server enables interaction with a runningClojure nREPL instance, allowing evaluation of Clojure code, namespace inspection, and other utilities via MCP.

- Connectto a running nREPL server by specifying host and port.
- Evaluate Clojure codein a given namespace or the current one.
- List project namespacesusingtools.namespace.
- Retrieve nREPL connection status, including host, port, and session details.
- Inspect public varsin any Clojure namespace, displaying metadata such as docstrings and values.

Installing in CLine (VSCode) or Claude Desktop

To use this server withCLineorClaude Desktop, follow these steps:
- OpenCLinein VSCode orClaude Desktop.
- Navigate to theMCP Settings.
- Add a new MCP server with the following configuration:

{ "mcpServers": { "nrepl-mcp-server": { "command": "npx", "args": [ "nrepl-mcp-server" ], "disabled": false, "autoApprove": [] } } }

This will allow the client to communicate with the nREPL MCP server via standard input/output.

To quickly run the server without cloning the repository:
- Clone the repository
- Install dependencies

npm install

- Production Mode: Runs from compiled output.

npm start