Modex
Modex is a Clojure MCP Library to augment your AI models with Tools, Resources & Prompts using Clojure (Model Context Protocol). Implements MCP Server & Client.
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
Maintainer
Works with
Installation
Manual Installation
npx modexConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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 modexBuild 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 uberNote 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-*.jarConfigure 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"]
}
}
}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.
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.
Modex Alternatives — Similar Developer Tools Servers
Looking for alternatives to Modex? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
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.
Set Up Modex in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.