Modex MCP

MCPAI代理

提供方 theronic

AI代理 SSE · 服务端推送 无需鉴权 社区 / 第三方 Claude DesktopClaude

Modex是一个Clojure库,用于通过实现模型上下文协议(MCP)来扩展AI模型的功能,包括工具、资源和提示的集成。

一句话选型结论

按资料字段整理

Modex MCP 属于AI代理类 MCP 服务器,SSE · 服务端推送,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式SSE · 服务端推送 鉴权无需鉴权 部署方式远程部署
GitHub 星标 114 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Clojure本地部署AI扩展Clojure库模型上下文协议工具集成

安装与配置

SSE · 服务端推送 无需鉴权
早期远程传输方式,正在被 HTTP 取代
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Modex MCP当前 未标注 SSE · 服务端推送 远程部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方theronic上游标注的维护方 theronic
分类AI代理本站按上游分类展示
连接方式SSE · 服务端推送早期远程传输方式,正在被 HTTP 取代
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

10.1 KB
来自项目仓库与上游目录的原文,未做删改

Modex:Clojure中的模型上下文协议服务器和客户端库

Modex(MOdel+ContEXt)是一个Clojure库,可以让你用新的工具、资源和提示来增强你的人工智能。

Modex实现了(大部分) 模型上下文协议 在“原生”Clojure中构建MCP服务器和客户端。

因为它是原生的Clojure,你不需要处理Anthropic的 MCP Java SDK.

Modex实现了 stdio 2024-11-05 MCP规范中的传输,因此不需要像这样的代理
mcp代理 在SSE\<=>stdio之间进行转换,反之亦然。

Modex在行动中的截图

Claude Desktop可以通过其MCP客户端与Modex MCP服务器通信:

目录

  1. 快速启动
  2. 什么是MCP?
  3. Modex能做什么?
  4. 详细的分步说明
  5. 实施
  6. 项目状态
  7. 依据
  8. 常见问题解答
  9. 许可证

示例工具

  • Datomic MCP 使用Modex公开Datomic工具,以便您的模型可以在开发或产品中查询数据库模式和数据。

快速启动

  1. git clone git@github.com:theronic/modex.git
  2. cd modex
  3. ./build.sh 在 target/modex-mcp-0.2.2.jar.
  4. 在以下位置打开您的Claude桌面配置 ~/Library/Application\ Support/Claude/claude_desktop_config.json
  5. 配置一个新的MCP服务器,该服务器将在其 完整路径:```json
    {
    "mcpServers": {
    "modex-mcp-hello-world": {
    "command": "java",
    "args": ["-jar", "/Users/your-username/code/modex/target/modex-mcp-0.2.2.jar"]
    }
    },
    "globalShortcut": ""
    }

6. 重新启动Claude Desktop以激活新的MCP服务器+工具:)(Cmd+R刷新不会重新加载配置,只会重新启动工具)
1. 告诉Claude“用123运行inc工具”,授权该工具,你应该看到124的输出。

## 什么是MCP?

MCP允许您使用工具、资源和提示来增强您的AI模型:

- **工具** 它可以做的事情,比如查询数据库(例如Datomic)。
- **资源** 是它可以读取的文件和数据,如PDF银行对账单。
- **提示** 是模板化的消息和工作流。

## 用例

调制解调器由以下人员使用 数据经济学mcp,它将我们的生产Datomic数据库暴露给像Claude Desktop这样的MCP客户端。AI模型通过读取我们的数据库模式并运行检查服务器状态和IP的查询来智能诊断生产中的支持查询,因此它可以尝试访问它并将VM的期望状态与集群中的实际状态进行比较。

随着时间的推移,我希望使用Modex+其他MCP工具自动化我们的大部分定期支持查询。

## Modex能做什么?

### 完整示例

中有一个MCP服务器示例 src/modex/mcp/core.clj 它使用一些基本工具定义了MCP服务器。

您的MCP客户端(例如Claude Desktop)可以连接到此服务器,并使用公开的工具为您的AI模型提供额外的上下文。

## 数据结构

### 工具

在内部,工具只是 `Tool` 记录几个 `Parameter` 论据:

- `(defrecord Tool [name doc args handler])`
- `(defrecord Parameter [name doc type required default])`

然而,使用以下方式定义工具更方便 `tool` &amp; `tools` 下面的宏。

### 描述一个单独的工具 `tool` 宏:

这 `tool` 宏观行为如下 `defrecord`,其中处理程序定义采用参数映射ala `{:keys [arg1 arg2 ...]}` 但有额外的(可选)地图 `:type`, `:or` &amp; `:doc`此元数据用于向MCP客户端描述该工具。

- MCP规范目前仅支持 `:string` &amp; `:number` 刀具参数类型。
- 存在于 `:or` 地图意味着可选性。
- 缺少参数docstring默认为参数名称字符串。```clojure
(require &#x27;[modex.mcp.tools :as tools])

(def add-tool
(tools/tool
; feels like defrecord.
(add [{:keys [x y]
:type {x :number
y :number}
:or   {y 0} ; y is optional due to its presence in the :or map.
:doc  {x &quot;First number&quot;
y &quot;Second number&quot;}}]
[(+ x y)]))) ; tools should return a vector (to support multiple values).

使用以下命令调用工具 invoke-tool 包括验证:

调用使用参数映射,就像MCP客户端对 tools/call 请求:```clojure
(tools/invoke-tool add-tool {:x 5 :y 6}) ; Modex will map these arguments and call the handler.
=> {:success true, :results [11]} ; note :results is vector to support multiple values.


### 直接调用工具处理程序以跳过验证和错误处理:```clojure
(tools/invoke-handler (:handler add-tool) {:x 5 :y 6})
=&gt; [11] ; note vector result to support multiple values.

使用定义工具集 tools 宏

这 tools 宏只是调用 tool 宏用于每个工具定义,并返回一个基于工具名称(关键字)的工具映射:``clojure (def my-tools &quot;Define your tools here.&quot; (tools/tools (greet &quot;Greets a person by name.&quot; ; tools can have a docstring [{:keys [first-name last-name] :doc {first-name &quot;A person&#x27;s first name.&quot; last-name &quot;A person&#x27;s last name (optional).&quot;} :type {first-name :string last-name :string} :or {last-name nil}}] ; last-name is optional, implied by presence in:or` map.
; tools should return collection.
[(str "Hello from Modex, "
(if last-name ; args can be optional
(str first-name " " last-name)
first-name) "!")])

(add
"Adds two numbers."
; Tool handler args also support deprecated vector arg-style,
; but this is superseded by the newer map-destructuring style:
[^{:type :number :doc "First number to add."} a
^{:type :number :doc "Second number to add."} b]
[(+ a b)])

(subtract
"Subtracts two numbers (- a b)"
[^{:type :number :doc "First number."} a
^{:type :number :doc "Second number."} b]
[(- a b)])

(error-handling
"This tool throws intentionally. Modex will handle errors for you."
[]
(throw (ex-info "Modex will handle exceptions." {})))))


### 创建Modex MCP服务器+工具:```clojure
(require &#x27;[modex.mcp.server :as server])
(def my-mcp-server
&quot;Here we create a reified instance of AServer. Only tools are presently supported.&quot;
(server/-&gt;server
{:name       &quot;Modex MCP Server&quot;
:version    &quot;0.0.2&quot;
:initialize (fn [_init-params] ; init-params, but may contain client capabilities in future.
&quot;Do long-running setup &amp; blocking I/O here, like connecting to prod database.&quot;)
:tools      my-tools
:prompts    nil    ; Prompts are WIP.
:resources  nil})) ; Resources are WIP.

启动MCP服务器```clojure

(server/start-server! my-mcp-server)


或者把它放在你的 `-main` 功能。

### 协议

Modex暴露了一个 `AServer` 协议和DSL,用于定义描述MCP服务器的工具协议,这些协议公开了工具、资源和提示。

A服务器协议:```clojure
(defprotocol AServer
(protocol-version [this])

(server-name [this])
(version [this])

(capabilities [this])

(initialize [this _init-params]) ; init-params is empty for now, but may contain client capabilities in future.

(list-tools [this])
(call-tool [this tool-name arg-map])

(list-resources [this])
(list-prompts [this]))

详细的分步说明

第一步:构建Uberjar

在运行它之前,你必须先构建它。构建输出一个uberjar,它类似于Java可执行文件。```bash
clojure -T:build uber


或者运行执行该操作的助手:```bash
./build.sh

(你可能需要跑步 chmod +x build.sh)

步骤2:打开Claude桌面配置

打开您的Claude桌面配置文件, claude_desktop_config.json,在MacOS上应位于:```
~/Library/Application\ Support/Claude/claude_desktop_config.json


### 步骤3:配置MCP服务器

在下面添加一个元素 `mcpServers` 所以看起来像这样:```json
{
&quot;mcpServers&quot;: {
&quot;modex&quot;: {
&quot;command&quot;: &quot;java&quot;,
&quot;args&quot;: [&quot;-jar&quot;, &quot;/Users/your-username/code/modex/target/modex-mcp-0.2.2.jar&quot;]
}
},
&quot;globalShortcut&quot;: &quot;&quot;
}

这个消息告诉克劳德桌面有一个名为 modex 它可以通过运行连接到 java -jar /path/to/your/uber.jar.

其工作方式是,您的本地MCP客户端(即Claude Desktop)启动您的MCP服务器进程,并通过stdin/stdout管道与其通信。

步骤4:重新启动克劳德桌面

现在,你应该可以问Claude“run foo”或“foo说什么?”,它就会运行
这 foo 工具,并回复“你好,AI!”。

实施

Modex在Clojure中实现了MCP客户端和服务器 大多 符合 2024-11-05 MCP规范.

消息使用JSON-RPC 2.0有线格式进行编码。

有三种消息类型:

  • 请求有 {:keys [id method ?params]}
  • 回应有 {:keys [id result ?error]}
  • 通知已 {:keys [method ?params}

MCP支持两种传输类型:

  • [x] stdio/ststdout——在Modex中实现。
  • []服务器发送事件(SSE)-尚未实现。适用于受限网络

项目状态

  • [x] 通过测试
  • [x] 人机工程学(服务器/客户端协议?)
  • [x] 工具
  • [x] nREPL用于实时更改正在运行的进程
  • []资源
  • []提示
  • [进行中]SSE支持
  • [进行中]流式HTTP支持(2025-03-26 MCP规范)

依据

有一个现有的图书馆 mcp clj 它使用SSE,因此需要mcp代理从SSE\<=>stdio进行代理。我对此很恼火,所以我做了Modex。

常见问题解答

当MCP客户端(如Claude Desktop)连接时,我可以修改服务器吗?

还没有,但我很快就会添加一个nREPL,这样你就可以在Claude Desktop连接到进程时评估更改,而无需重建uberjar。

顺便说一句,我试着让它跑起来 clojure -M -m modex.mcp.server,但您无法设置Claude Desktop的工作目录。

所以目前,我重建了uberjar并重新启动了Claude Desktop。会修好的。

感谢付费Modex客户:

  • Next文档 –Salesforce的文档流
  • 跳跃 --小型企业会计软件

许可证

总之:

  • 非商业用途免费:使用它、修改它、在下共享它 GPLv3 免费,只要保持开源。
  • 商业用途:想将更改保密吗?一次性支付20美元获得永久商业许可证。这涵盖了我在公共场合继续构建AI代币的成本。

此工具根据 GNU通用公共许可证v3.0(GPLv3)。您可以自由使用、修改和分发它,前提是任何衍生作品也根据GPLv3获得许可并开源。这确保了该工具可供社区免费使用,同时要求任何更改都具有透明度。

如果你想在专有项目中使用或修改这个工具,而不在GPLv3下发布你的更改,你
可以购买商业许可证。这允许您将您的修改保密,以供个人或商业使用。
要获得商业许可证,请通过以下方式联系我 modex@petrus.co.za.

作者

  • 佩特鲁斯·塞隆

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Modex MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Modex MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是SSE · 服务端推送,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Modex MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Modex MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Modex MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Modex MCP 能提供哪些能力?

资料显示能力标签包括 AI扩展、Claude、工具集成。具体工具清单以官方文档为准。

Modex MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Modex MCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为SSE · 服务端推送。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。