Nrepl MCP

🚀 Basilisp nREPL MCP 桥接器

该项目搭建了一座桥梁，连接了 Anthropic 的模型控制协议（MCP）与 Basilisp 的 nREPL 服务器，让 Claude Code 能够直接与 Basilisp REPL 进行交互。目前，它理论上可与任何 nREPL 配合使用，不过当前的提示信息是针对 Basilisp 定制的。

🚀 快速开始

安装依赖

本项目需要以下依赖：

• uv
• basilisp

操作步骤

1. 启动 Basilisp nREPL 服务器：

   basilisp nrepl-server --port 36915
   

2. 将 MCP 桥接器添加到 Claude Code：

   claude mcp add /home/a/subjective/snr/basilisp_mcp_bridge.py
   

3. 使用 Claude 并调用可用工具：
   • eval_code(code) - 评估 Basilisp 代码
   • get_docs(symbol) - 获取符号的文档
   • find_namespace_vars(namespace) - 列出命名空间中的变量
   • list_namespaces() - 列出所有可用命名空间
   • check_connection() - 验证 nREPL 连接状态

✨ 主要特性

• 代码执行与结果展示：执行代码并接收美观打印且语法高亮的结果。
• 文档获取：获取符号的文档。
• 命名空间管理：列出所有可用命名空间，查找命名空间中的所有变量。
• 连接检查：检查 nREPL 服务器的连接状态。
• Python 互操作性：Basilisp 支持 Python 互操作性，具有适当的语法以访问属性和调用方法。
• 错误处理：增强的错误报告和格式化。

💻 使用示例

基础用法

;; 导入模块
(import [math :as math])

;; 访问属性
(. math -pi)  ;; 或 (.-pi math)

;; 调用方法
(.sin math 0)

;; 创建 Python 数据结构
#py{"key" "value"}

📚 详细文档

未来改进

• 实现一个完整的 bencode 解析器（超出正则表达式的范围）。
• 添加会话管理以支持多个 REPL。
• 添加自动完成功能。