nREPL MCP 服务器

一个为 MCP 客户端设计的 模型上下文协议 (MCP) 服务器，例如 Claude Desktop 或 VSCode 中的 CLine。当与 CLine 一起使用时，此服务器可以与任何 LLM 一起使用。该服务器允许与正在运行的 Clojure nREPL 实例 进行交互，通过 MCP 评估 Clojure 代码、检查命名空间和其他实用功能。

功能

• 连接 到正在运行的 nREPL 服务器，指定主机和端口。
• 在给定的命名空间或当前命名空间中 评估 Clojure 代码。
• 使用 tools.namespace 列出项目命名空间。
• 检索 nREPL 连接状态，包括主机、端口和会话详细信息。
• 检查任何 Clojure 命名空间中的 公共变量，显示元数据如文档字符串和值。

安装与设置

在 CLine (VSCode) 或 Claude Desktop 中安装

要将此服务器与 CLine 或 Claude Desktop 一起使用，请按照以下步骤操作：

1. 在 VSCode 中打开 CLine 或 Claude Desktop。
2. 导航到 MCP 设置。
3. 添加一个新的 MCP 服务器，并配置如下：

   {
     "mcpServers": {
       "nrepl-mcp-server": {
         "command": "npx",
         "args": [
           "nrepl-mcp-server"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

4. 保存并重启客户端以应用更改。

这将允许客户端通过标准输入/输出与 nREPL MCP 服务器通信。

通过 npx 安装

要快速运行服务器而无需克隆仓库：

npx nrepl-mcp-server

手动安装

1. 克隆仓库

2. 安装依赖

   npm install
   

3. 构建项目（将 TypeScript 转译为 JavaScript）

   npm run build
   

4. 运行服务器

   • 生产模式：从编译后的输出运行。

     npm start
     

   • 开发模式：使用 ts-node 进行实时更改。

     npm run dev
     

这将启动服务器，监听 STDIO 上的 MCP 请求。MCP 客户端将为您启动服务器。

操作

连接到 nREPL

通过指定 主机 和 端口 来建立与 nREPL 服务器的连接。

评估 Clojure 代码

在 默认命名空间 或 指定命名空间 中执行任意 Clojure 表达式。

检索命名空间信息

使用 tools.namespace 列出当前项目目录中的所有命名空间。

检查公共变量

获取指定命名空间中所有 公共变量 的元数据和当前值。

获取 nREPL 连接状态

提供当前 nREPL 连接的详细信息，包括主机、端口、会话 ID 以及最后的错误（如果有）。

资源

nrepl://status

提供有关当前 nREPL 连接的信息，包括：

• 主机和端口
• 连接状态
• 活动会话 ID

nrepl://namespaces

列出项目目录中检测到的所有命名空间。

贡献

欢迎贡献！如果您有功能建议或错误报告，请打开一个 issue 或 pull request。

许可证

本项目采用 MIT 许可证。请根据其条款自由修改和分发。