nREPL MCP Server

nREPL MCP 服务器

专为 MCP 客户端（例如Claude Desktop或 VSCode 中的CLine ）设计的模型上下文协议 (MCP)服务器。此服务器与 CLine 配合使用时，可与任何 LLM 配合使用。此服务器支持与正在运行的Clojure nREPL 实例进行交互，从而允许通过 MCP 执行 Clojure 代码评估、检查命名空间以及其他实用程序。

特征

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

安装和设置

在 CLine (VSCode) 或 Claude Desktop 中安装

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

1. 在 VSCode 或Claude Desktop中打开CLine 。
2. 导航至MCP 设置。
3. 添加一个新的 MCP 服务器，配置如下：
   { "mcpServers": { "nrepl-mcp-server": { "command": "npx", "args": [ "nrepl-mcp-server" ], "disabled": false, "autoApprove": [] } } }
4. 保存并重新启动客户端以应用更改。

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

通过npx安装

要快速运行服务器而不克隆存储库：

手动安装

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 许可证。请根据其条款随意修改和分发。