Clj Kondo

🚀 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