mcp-clj

A MCP server written in clojure

Catalog onlyCatalog onlySTDIO

Overview

mcp-clj is a Clojure implementation of the Model-Channel Protocol (MCP) designed to expose Clojure REPL functionality over an SSE transport.

To use mcp-clj, add it as a dependency to your project and start the server on your desired port. Connect to the server using an MCP client.

Implements the Model-Channel Protocol (MCP) in Clojure. - Exposes Clojure REPL functionality. - Simple and reliable implementation compatible with Anthropic's MCP specification.

Enabling Clojure REPL functionality over a network.
Facilitating communication between Clojure applications using the MCP.
Supporting development and debugging of Clojure applications.

Add to your AI client

Use these steps to connect mcp-clj in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-clj-hugoduncan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-clj-hugoduncan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-clj-hugoduncan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-clj-hugoduncan": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-clj-hugoduncan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-clj-hugoduncan": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-clj-hugoduncan"
      ]
    }
  }
}

FAQ

What is the Model-Channel Protocol (MCP)?

MCP is a protocol designed for communication between clients and servers, allowing for efficient data exchange.

How do I contribute to mcp-clj?

You can contribute by forking the repository, creating a new branch, making changes, and submitting a pull request.

Is mcp-clj open source?

Yes, mcp-clj is licensed under the MIT License.

Developer tools