Modex

v1.0.0Developer Toolsstable

Modex is a Clojure MCP Library to augment your AI models with Tools, Resources & Prompts using Clojure (Model Context Protocol). Implements MCP Server & Client.

clojurejson-rpcmcpmcp-clientmcp-server
Share:
114
Stars
0
Downloads
0
Weekly
0/5

What is Modex?

Modex is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to modex is a clojure mcp library to augment your ai models with tools, resources & prompts using clojure (model context protocol). implements mcp server & client.

Modex is a Clojure MCP Library to augment your AI models with Tools, Resources & Prompts using Clojure (Model Context Protocol). Implements MCP Server & Client.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Modex is a Clojure MCP Library to augment your AI models wit

Use Cases

Build MCP servers in Clojure with tools, resources, and prompts.
Implement both MCP client and server functionality using Clojure.
Leverage JSON-RPC and stdio transports for MCP implementations.
theronic

Maintainer

LicenseMIT
Languageclojure
Versionv1.0.0
UpdatedApr 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx modex

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Modex

Modex is a Clojure library that lets you build MCP (Model Context Protocol) servers and clients entirely in Clojure, using idiomatic macros to define tools, resources, and prompts that AI models can call. It implements the 2024-11-05 MCP specification over stdio transport, making it straightforward to expose Clojure functions—such as Datomic database queries or business logic—to AI assistants like Claude. Developers who work in Clojure-based backend stacks use Modex to avoid context-switching to other languages when adding AI tool integrations.

Prerequisites

  • Java JDK 11 or later (for running the compiled uberjar)
  • Clojure CLI tools and deps.edn (for building from source)
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • Git to clone the repository
1

Clone the Modex repository

Clone the repository to your local machine to access the source code and build scripts.

git clone [email protected]:theronic/modex.git
cd modex
2

Build the uberjar

Compile the project into a standalone JAR file using the provided build script or the Clojure tools build alias.

./build.sh
# or
clojure -T:build uber
3

Note the output JAR path

After a successful build, the JAR is placed in the target directory. Note the full absolute path—you will need it in the Claude Desktop configuration.

ls target/modex-mcp-*.jar
4

Configure your MCP client

Add Modex as an MCP server in your Claude Desktop config file. Replace /full/path/to with the actual absolute path to the JAR on your machine.

{
  "mcpServers": {
    "modex": {
      "command": "java",
      "args": ["-jar", "/full/path/to/modex-mcp-0.2.2.jar"]
    }
  }
}
5

Restart Claude Desktop

Quit and relaunch Claude Desktop so it picks up the new MCP server configuration. The server will start automatically when Claude Desktop launches.

6

Define custom tools in Clojure

Use the Modex `tool` macro in your own Clojure project to expose functions as MCP tools. Tools can accept :string and :number parameters and return vectors of values.

(require '[modex.mcp :as mcp])

(mcp/tool "greet"
  "Returns a personalized greeting"
  [{:name "name" :type :string :description "The person's name"}]
  (fn [{:keys [name]}]
    [(str "Hello, " name "!")]))

Modex Examples

Client configuration for Claude Desktop

MCP server entry for running the compiled Modex JAR via Java. Replace the path with the actual path to your built JAR.

{
  "mcpServers": {
    "modex": {
      "command": "java",
      "args": ["-jar", "/Users/yourname/modex/target/modex-mcp-0.2.2.jar"]
    }
  }
}

Prompts to try

Once Modex is running with your custom tools defined, try these example interactions.

- "Greet Alice using the greet tool"
- "Add 42 and 58 using the add tool"
- "Query the database schema using the Datomic tool"
- "What tools are available in the Modex server?"

Troubleshooting Modex

Claude Desktop shows the server as disconnected or fails to start

Verify the JAR path in the config is an absolute path (not relative). Run java -jar /full/path/to/modex-mcp-0.2.2.jar manually in a terminal to check for Java version errors or missing classpath issues. Java 11+ is required.

Build fails with 'command not found: clojure'

Install the Clojure CLI tools from https://clojure.org/guides/install_clojure. On macOS you can use: brew install clojure/tools/clojure

Tool parameters are rejected or cause errors

Modex currently supports only :string and :number parameter types. Ensure all tool parameter type annotations use these exact keywords. Complex types such as maps or arrays are not yet supported.

Frequently Asked Questions about Modex

What is Modex?

Modex is a Model Context Protocol (MCP) server that modex is a clojure mcp library to augment your ai models with tools, resources & prompts using clojure (model context protocol). implements mcp server & client. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Modex?

Follow the installation instructions on the Modex GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Modex?

Modex works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Modex free to use?

Yes, Modex is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "modex": { "command": "npx", "args": ["-y", "modex"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Modex?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides