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。
• 添加自動完成功能。