# modex

> MCP Server

Modex is a Clojure library implementing the Model Context Protocol, enabling developers to augment AI models with tools, resources, and prompts without relying on Java SDKs or proxies.

## Overview

- **Category:** AI
- **Language:** Clojure
- **Stars:** 118
- **Forks:** 1
- **Owner:** theronic
- **GitHub:** https://github.com/theronic/modex
- **Homepage:** http://petrustheron.com/
- **Created:** 2025-03-05T09:16:40+00:00
- **Updated:** 2025-03-28T23:48:40+00:00
- **Source:** https://model-context-protocol.com/servers/clojure-ai-model-context-protocol-library

## Setup

## Setup

1.  `git clone git@github.com:theronic/modex.git`
2.  `cd modex`
3.  `./build.sh` builds an uberjar at `target/modex-mcp-0.1.0.jar`.
4.  Open your Claude Desktop Config at `~/Library/Application\ Support/Claude/claude_desktop_config.json`
5.  Configure a new MCP Server that will run the uberjar at its _full path_:

```json
{
  "mcpServers": {
    "modex-mcp-hello-world": {
      "command": "java",
      "args": ["-jar", "/Users/your-username/code/modex/target/modex-mcp-0.1.0.jar"]
    }
  },
  "globalShortcut": ""
}
```

6.  Restart Claude Desktop to activate your new MCP Server + tools :)
7.  Tell Claude to "run the inc tool with 123", authorize the tool and you should see an output of 124.

## Tools

## Available Tools

1.  Tools (augment AI models with actions like querying a database). 
2.  Resources (augment AI models with files and data it can read). 
3.  Prompts (augment AI models with templated messages and workflows). 
4.  `tool` macro (describe a tool). 
5.  `invoke-tool` (invoke a tool with a map of arguments). 
6.  `tools` macro (define a toolset). 
7.  AServer protocol (define MCP servers that expose tools, resources & prompts).

