Clj Kondo MCP

🚀 clj-kondo MCP 服務器

一個提供 Clojure/ClojureScript/EDN 文件 clj-kondo 檢查功能的 Model Context Protocol (MCP) 服務器。適用於 Claude 編碼和桌面環境，因為這些地方沒有內置的檢查功能。你可以考慮編輯你的 CLAUDE.md 文件，要求它在編輯後進行檢查。

✨ 主要特性

• 通過 MCP 工具調用對 Clojure 文件進行檢查
• 支持所有 clj-kondo 分析功能
• 可選的顯式配置目錄支持

📦 安裝指南

快速安裝

npx clj-kondo-mcp

或進行 IDE 配置：

{
  "mcpServers": {
    "clj-kondo": {
      "command": "npx",
      "args": ["clj-kondo-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

手動安裝

1. 安裝 clj-kondo： 確保你已經安裝了 clj-kondo 並且它在你的系統 PATH 中可用。查看平臺的安裝說明。
2. 安裝依賴項：

npm install

3. 構建服務器：

npm run build

💻 使用示例

基礎用法

運行服務器

node build/index.js

MCP 工具調用

該服務器提供一個工具：

lint_clojure - 檢查 Clojure/ClojureScript/EDN 內容

參數：

{
  "file": "/absolute/path/to/file.clj", // 必須是絕對路徑，可以是文件、目錄或類路徑
  "configDir": "/absolute/path/to/config/dir", // 可選，如果提供必須是絕對路徑
  "level": "warning" // 可選，默認為 error 級別
}

file 參數接受：

• 單個文件路徑（例如："/path/to/src/my_file.clj"）
• 目錄路徑（例如："/path/to/src"） - 將遞歸檢查所有 .clj、.cljs 和 .cljc 文件
• 類路徑字符串 - 將檢查類路徑中的所有 Clojure 文件
  • 對於 Leiningen 項目：使用 lein classpath 的輸出
  • 對於 deps.edn 項目：使用 clojure -Spath 的輸出

注意：由於 MCP 服務器作為單獨進程運行，因此 file 和 configDir 參數必須是絕對路徑。相對路徑無法正常工作。

默認情況下，clj-kondo 會自動在當前目錄和父目錄的 .clj-kondo 目錄中查找配置。你可以通過指定 configDir 參數來覆蓋此行為，指向特定的配置目錄。

有關 clj-kondo 配置的更多信息，請參閱官方文檔。

📚 詳細文檔

配置

添加到你的 MCP 設置文件中（對於 Cline，位於 ~/Library/Application Support/Code - Insiders/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "clj-kondo": {
      "command": "npx",
      "args": ["clj-kondo-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

對於手動構建，請使用：

{
  "mcpServers": {
    "clj-kondo": {
      "command": "node",
      "args": ["build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

構建

npm run build

監視模式

npm run dev