Basilisp nREPL MCP Bridge

基本能力

产品定位

Basilisp nREPL MCP Bridge 是一个开发工具，旨在为 Basilisp 开发者提供一个高效的交互式编程环境，通过 MCP 协议与 nREPL 服务器进行通信。

核心功能

• 执行代码并接收格式化和语法高亮的结果
• 获取符号的文档
• 列出所有可用的命名空间
• 查找命名空间中的所有变量
• 检查 nREPL 服务器连接状态
• Basilisp 与 Python 的互操作性，支持属性访问和方法调用的正确语法
• 增强的错误报告和格式化

适用场景

• Basilisp 开发中的交互式代码执行和调试
• 快速查询和浏览 Basilisp 代码库的文档和命名空间
• 在 Basilisp 中集成和调用 Python 代码

工具列表

• eval_code(code) - 评估 Basilisp 代码
• get_docs(symbol) - 获取符号的文档
• find_namespace_vars(namespace) - 列出命名空间中的变量
• list_namespaces() - 列出所有可用的命名空间
• check_connection() - 验证 nREPL 连接

常见问题解答

无

使用教程

使用依赖

• 需要安装 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

调试方式

连接 Claude 并使用提供的工具进行交互式调试。

Python 互操作性示例

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

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

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

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

未来改进

• 实现一个适当的 bencode 解析器（超越正则表达式）
• 添加多 REPL 的会话管理
• 添加自动补全支持

许可证

None