MCP Clj

MCP开发工具

提供方 hugoduncan

开发工具 未标注 无需鉴权 社区 / 第三方 Claude DesktopClaude

A MCP server written in clojure

一句话选型结论

按资料字段整理

MCP Clj 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 57 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

支持客户端

适用场景

developer-toolsClojure本地部署ClojureREPL模型上下文协议开发工具服务器实现客户端实现

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

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

值得选的地方

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

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Clj当前 未标注 未标注 未标注 无 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

一个具有最小依赖且集成有自包含Clojure REPL的Clojure语言实现的模型上下文协议(MCP)。

快速入门```bash

Add to deps.edn

{:deps {org.hugoduncan/mcp-clj
{:git/url "https://github.com/hugoduncan/mcp-clj"
:git/sha "latest-commit-sha"
:deps/root "projects/server"}}}
``````clojure
;; Start MCP server
(require 'mcp-clj.mcp-server.core)
(def server (mcp-clj.mcp-server.core/create-server {:transport {:type :stdio}}))

;; Server exposes tools like clj-eval and ls
;; Connect with Claude Desktop via stdio transport (see Claude Desktop Setup)


## 什么 & 为什么

mcp-clj 同时提供了 **MCP服务器** 并且 **客户** 在Clojure中的实现:

- **自包含的REPL(读取-求值-打印循环)**直接在服务器进程中评估Clojure代码(无需nREPL依赖)
- **低依赖性**仅需 `org.clojure/data.json`
- **多种运输方式**SSE(HTTP)、stdio 和内存中测试
- **内置工具**Clojure 评估(`clj-eval`) 和文件列表 (`ls`) 支持 .gitignore 文件
- **MCP客户端**从Clojure连接到其他MCP服务器

**何时使用mcp-clj:**

- 将Clojure REPL功能暴露给Claude Desktop或其他MCP客户端
- 构建使用MCP服务的Clojure应用程序
- 简单部署,无需外部REPL依赖

**与Clojure-MCP的权衡对比:**

- ✅ 更简单的设置,独立完成评估
- ❌ 无法连接到现有的远程REPL
- ❌ 内置工具较少

## 安装

### Git 依赖项(推荐)```clojure
;; deps.edn
{:deps {org.hugoduncan/mcp-clj
{:git/url   "https://github.com/hugoduncan/mcp-clj"
:git/sha   "latest-commit-sha"  ; Replace with actual latest SHA
:deps/root "projects/server"}}}

CLI 使用方法```bash

Clone and run directly

git clone https://github.com/hugoduncan/mcp-clj
cd mcp-clj

Start stdio server (recommended for Claude Desktop)

clj -M:stdio-server

Start SSE server (HTTP) on port 3001 (default)

clj -M:sse-server

Start SSE server on custom port

clj -M:sse-server --port 8080


## 服务器使用情况

### 基本服务器```clojure
(require 'mcp-clj.mcp-server.core)

;; Stdio server (recommended for Claude Desktop)
(def server (mcp-clj.mcp-server.core/create-server
{:transport {:type :stdio}}))

;; SSE server (for HTTP-based clients)
(def server (mcp-clj.mcp-server.core/create-server
{:transport {:type :sse :port 3001}}))

;; Stop server
((:stop server))

自定义工具```clojure

(def echo-tool
{:name "echo"
:description "Echo the input text"
:inputSchema {:type "object"
:properties {"text" {:type "string"}}
:required ["text"]}
:implementation (fn [{:keys [text]}]
{:content [{:type "text" :text text}]
:isError false})})

;; Server with custom tools
(def server (mcp-clj.mcp-server.core/create-server
{:transport {:type :sse :port 3001}
:tools {"echo" echo-tool}}))

;; Add tools dynamically
(mcp-clj.mcp-server.core/add-tool! server echo-tool)


### 内置工具```json
{"name": "clj-eval", "arguments": {"code": "(+ 1 2 3)"}}
// Returns: "6"

ls列出文件并支持 gitignore```json
{"name": "ls", "arguments": {"path": "src", "max-depth": 2, "max-files": 50}}
// Returns: {"files": [...], "truncated": false, "total-files": 12}


## 客户端使用

从Clojure连接到其他MCP服务器:```clojure
(require 'mcp-clj.mcp-client.core)

;; Connect to stdio MCP server
(def client (mcp-clj.mcp-client.core/create-client
{:transport {:type :stdio
:command "clojure"
:args ["-M:stdio-server"]}
:client-info {:name "my-client" :version "1.0.0"}}))

;; Wait for connection
(mcp-clj.mcp-client.core/wait-for-ready client)

;; List available tools
(mcp-clj.mcp-client.core/list-tools client)
;; => {:tools [{:name "clj-eval" :description "..." :inputSchema {...}}]}

;; Call a tool
@(mcp-clj.mcp-client.core/call-tool client "clj-eval" {:code "(* 6 7)"})
;; => {:content [{:type "text" :text "42"}] :isError false}

;; Cleanup
(.close client)

克劳德代码设置

Claude Code 可以使用 stdio 传输方式连接到 mcp-clj 服务器。

1. 在你的项目中添加mcp-clj

在你的 deps.edn:```clojure
{:aliases
{:mcp {:extra-deps {org.hugoduncan/mcp-clj
{:git/url "https://github.com/hugoduncan/mcp-clj"
:git/sha "latest-commit-sha"
:deps/root "projects/server"}}
:main-opts ["-m" "mcp-clj.stdio-server.main"]}}}


### 2. 配置Claude代码

使用Claude Code的命令行界面(CLI)添加MCP服务器:```bash
claude mcp add mcp-clj clojure -M:mcp

3. 测试连接```bash

Verify the MCP server is configured and accessible

claude mcp list


你应该看看 `mcp-clj` 在可用服务器列表中。Claude 代码
现在将能够访问 `clj-eval` 和 `ls` 项目中的工具
上下文。

## Claude 桌面版安装

Claude Desktop 可以通过 stdio 传输直接连接到 mcp-clj
无需额外的代理工具。

### 1. 在你的项目中添加mcp-clj

在你的 `deps.edn`:```clojure
{:deps {org.hugoduncan/mcp-clj
{:git/url   "https://github.com/hugoduncan/mcp-clj"
:git/sha   "latest-commit-sha"
:deps/root "projects/server"}}

:aliases
{:mcp {:main-opts ["-m" "mcp-clj.stdio-server.main"]}}}

2. 配置Claude桌面版

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"mcp-clj": {
"command": "/opt/homebrew/bin/bash",
"args": [
"-c",
"cd /path/to/your/project && clojure -M:mcp"
],
"env": {
"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
}
}
}
}


**注**替换 `/path/to/your/project` 使用您实际的项目目录,并根据需要调整bash路径(`which bash` 找到你的(答案/东西)。

### 3. 重启Claude桌面版

克劳德现在将能够访问 `clj-eval` 和 `ls` 在项目环境中运行的工具。

## 发展

### 设置```bash
git clone https://github.com/hugoduncan/mcp-clj
cd mcp-clj

# Start REPL with all components
clj -M:dev

测试```bash

Fast unit tests (default)

clj -M:kaocha:dev:test

Integration tests (starts servers)

clj -M:kaocha:dev:test --focus :integration

All tests

clj -M:kaocha:dev:test --focus :unit :integration

Specific namespace

clj -M:kaocha:dev:test --focus mcp-clj.mcp-server.core-test


### REPL 开发```clojure
;; After adding dependencies to deps.edn
(require 'clojure.repl.deps)
(clojure.repl.deps/sync-deps)

;; Reload namespace
(require 'my.namespace :reload)

;; Run tests
(require 'clojure.test)
(clojure.test/run-tests 'mcp-clj.mcp-server.core-test)

更新日志

在本地生成变更日志

安装 git-cliff:```bash

macOS

brew install git-cliff

Or download from https://github.com/orhun/git-cliff/releases


生成变更日志:```bash
# Preview unreleased changes
git cliff --unreleased

# Update CHANGELOG.md
git cliff -o CHANGELOG.md

建筑学

mcp-clj 使用一个 Polylith风格的架构 基于组件的组织方式:

  • 组件 (components/) - 可重用功能(mcp服务器、mcp客户端、json-rpc、工具等)
  • 基地 (bases/) - 入口点(sse-server,stdio-server)
  • 项目 (projects/server/- 可部署的制品

关键组件

  • mcp-server/ - MCP协议服务器,配备工具、提示和资源
  • mcp-client/ - MCP协议客户端,用于连接服务器
  • json-rpc/ - 带有自动EDN/JSON转换的JSON-RPC 2.0
  • tools/ - 内置的MCP工具(clj-eval,ls)
  • *-transport/ - 多个传输层(SSE、stdio、HTTP、内存中)

所有组件均使用 mcp-clj 命名空间,并遵循带有MCP协议版本的JSON-RPC 2.0标准 2024-11-05。

做出贡献

  1. 为仓库创建分支(或:克隆仓库)
  2. 创建一个特性分支
  3. 进行更改并确保测试通过: clj -M:kaocha:dev:test
  4. 提交一个拉取请求

许可证

麻省理工学院许可证。参见 许可证 文件中有详细信息。

常见问题

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

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

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

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Clj 收费吗?

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

MCP Clj 需要 API Key 吗?

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

MCP Clj 支持哪些客户端?

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

MCP Clj 能提供哪些能力?

资料显示能力标签包括 服务器实现、开发工具、Claude。具体工具清单以官方文档为准。

热门专题

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

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