nREPL MCP服务器

一个为MCP客户端设计的服务器,用于与运行的Clojure nREPL实例交互,支持代码评估、命名空间检查和连接状态检索。

  • by JohanCodinha
  • TypeScript
  • 本地部署
  • 38 星标
  • 更新于
在 GitHub 查看 JohanCodinha/nrepl-mcp-server

使用说明

nREPL MCP服务器

A. 模型上下文协议(MCP) 为MCP客户端设计的服务器,例如 克劳德桌面 或 渐变群 在VSCode中。当与CLine一起使用时,此服务器可以与任何LLM一起使用。此服务器允许与正在运行的 Clojure nREPL实例,允许通过MCP评估Clojure代码、命名空间检查和其他实用程序。


特性

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

安装和设置

在CLine(VSCode)或Claude Desktop中安装

使用此服务器 渐变群 或 克劳德桌面,请按照以下步骤操作:

  1. 打开 渐变群 在VSCode中或 克劳德桌面.
  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节点进行实时更改。
      npm run dev
      

这将启动服务器,监听 标准输入输出 对于MCP请求。Mcp客户端将为您启动服务器。


行动

连接到nREPL

允许通过指定以下参数建立与nREPL服务器的连接 主机 和 端口.

评估Clojure代码

执行任意Clojure表达式 默认命名空间 或a 指定的命名空间.

正在检索命名空间信息

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

检查公共变量

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

正在获取nREPL连接状态

提供当前nREPL连接的详细信息,包括主机、端口、会话ID和上次错误(如果有)。


资源

nrepl://status

提供有关当前nREPL连接的信息,包括:

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

nrepl://namespaces

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


贡献

欢迎投稿!如果您有功能建议或错误报告,请打开问题或拉取请求。

许可证

该项目根据 MIT许可证。请随时根据其条款进行修改和分发。