nREPL MCP Server

nREPL MCP Server

site icon
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 installnpm run buildnpm startnpm run dev

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 确保已安装 npx(通常随 Node.js 一起安装)。

安装教程

  1. 快速安装bash npx nrepl-mcp-server
  2. 手动安装bash git clone <repository-url> cd nrepl-mcp-server npm install npm run build npm start

调试方式

  1. 在开发模式下运行服务器以支持实时更改: bash npm run dev
  2. 检查 nREPL 连接状态: bash curl http://localhost:<port>/nrepl://status
  3. 列出项目命名空间: bash curl http://localhost:<port>/nrepl://namespaces

许可证

该项目遵循 MIT 开源许可条款。