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

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

---

贡献

欢迎贡献！如果您有功能建议或错误报告，请打开一个问题或拉取请求。

许可证

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