
nREPL MCP Server

2025.03.11
23
JavaScriptClojure 开发工具nREPL 交互工具开发效率
nREPL MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,专为 MCP 客户端(如 Claude Desktop 或 VSCode 中的 CLine)设计。该服务器可以与任何大型语言模型(LLM)一起使用,特别是与 CLine 结合时。它允许与正在运行的 Clojure nREPL 实例进行交互,支持通过 MCP 评估 Clojure 代码、检查命名空间以及其他实用功能。
View on GitHub
Overview
基本能力
产品定位
nREPL MCP Server 是一个用于开发环境的工具,旨在通过 MCP 协议与 Clojure nREPL 实例进行交互,提供代码评估、命名空间检查等功能。
核心功能
- 连接到运行的 nREPL 服务器:通过指定主机和端口建立连接。
- 评估 Clojure 代码:在给定的命名空间或当前命名空间中执行 Clojure 表达式。
- 列出项目命名空间:使用
tools.namespace
列出当前项目目录中的所有命名空间。 - 检查公共变量:获取指定命名空间中所有公共变量的元数据和当前值。
- 获取 nREPL 连接状态:提供当前 nREPL 连接的详细信息,包括主机、端口、会话 ID 和最后错误(如果有)。
适用场景
- 在 VSCode 中使用 CLine 进行 Clojure 开发。
- 在 Claude Desktop 环境中与 Clojure nREPL 实例交互。
- 需要快速评估和调试 Clojure 代码的开发场景。
工具列表
- npx nrepl-mcp-server:快速运行服务器而无需克隆仓库。
- npm install:安装项目依赖。
- npm run build:将 TypeScript 编译为 JavaScript。
- npm start:在生产模式下运行服务器。
- npm run dev:在开发模式下运行服务器,支持实时更改。
常见问题解答
- 如何配置 MCP 服务器? 在 CLine 或 Claude Desktop 的 MCP 设置中添加服务器配置,并重启客户端以应用更改。
- 如何手动安装和运行服务器?
克隆仓库后,依次运行
npm install
、npm run build
和npm start
或npm run dev
。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 确保已安装 npx(通常随 Node.js 一起安装)。
安装教程
- 快速安装:
bash npx nrepl-mcp-server
- 手动安装:
bash git clone <repository-url> cd nrepl-mcp-server npm install npm run build npm start
调试方式
- 在开发模式下运行服务器以支持实时更改:
bash npm run dev
- 检查 nREPL 连接状态:
bash curl http://localhost:<port>/nrepl://status
- 列出项目命名空间:
bash curl http://localhost:<port>/nrepl://namespaces