Clojure Nrepl

🚀 nREPL MCP 服務器

nREPL MCP 服務器是專門為 Model Context Protocol (MCP) 客戶端設計的，像 Claude Desktop 或者 VSCode 裡的 CLine 都能使用。此服務器可與任何大語言模型（LLM）配合（在通過 CLine 使用時），還能和運行中的 Clojure nREPL 實例 交互，實現指定命名空間或當前命名空間中評估 Clojure 代碼、檢查命名空間等實用功能。

🚀 快速開始

nREPL MCP 服務器可與多種客戶端配合使用，為您提供便捷的 Clojure 代碼評估和命名空間管理功能。下面為您介紹不同的安裝與使用方式。

✨ 主要特性

• 連接功能：可連接到正在運行的 nREPL 服務器，只需指定主機和端口。
• 代碼評估：能在指定的命名空間或當前命名空間中評估 Clojure 代碼。
• 命名空間管理：使用 tools.namespace 列出項目命名空間。
• 狀態檢索：可檢索 nREPL 連接狀態，包括主機、端口和會話詳細信息。
• 變量檢查：能檢查公開變量，獲取任何 Clojure 命名空間中的元數據（如文檔字符串和值）。

📦 安裝指南

在 CLine (VSCode) 或 Claude Desktop 中安裝

若要使用此服務器與 CLine 或 Claude Desktop，請按以下步驟操作：

1. 打開 VSCode 中的 CLine 或 Claude Desktop。
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-node 進行即時更改。

npm run dev

執行以上步驟後，服務器將啟動，偵聽標準輸入/輸出中的 MCP 請求。MCP 客戶端會為您啟動服務器。

💻 使用示例

基礎用法

以下是通過 npx 快速啟動服務器的示例：

npx nrepl-mcp-server

高級用法

手動安裝並在開發模式下運行服務器：

# 克隆倉庫
git clone <repository-url>
cd <repository-directory>

# 安裝依賴項
npm install

# 構建項目
npm run build

# 開發模式運行
npm run dev

📚 詳細文檔

操作說明

連接到 nREPL

允許通過指定 主機 和 端口 建立與 nREPL 服務器的連接。

評估 Clojure 代碼

可執行任意 Clojure 表達式，能在 默認命名空間 或 指定命名空間 中運行。

檢索命名空間信息

使用 tools.namespace 列出項目目錄中的所有命名空間。

檢查公開變量

獲取指定命名空間中所有 公共變量 的元數據和當前值。

檢索 nREPL 連接狀態

提供有關當前 nREPL 連接的詳細信息，包括主機、端口、會話 ID 和最後錯誤（如果有）。

資源信息

nrepl://status

提供有關當前 nREPL 連接的信息，包括：

• 主機和端口
• 連接狀態
• 活動會話 ID

nrepl://namespaces

列出項目目錄中檢測到的所有命名空間。

📄 許可證

該項目遵循 MIT License 許可，您可根據其條款自由修改和分發。

🔗 貢獻

歡迎大家貢獻代碼！如果您有任何功能建議或錯誤報告，請打開問題或拉取請求。