金大哥 - clj-kondo MCP 详情

article

README

🚀 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": []
    }
  }
}

手动安装

安装 clj-kondo：确保已经安装了 clj-kondo ，并且它已添加到系统的 PATH 中。可参考平台的安装说明进行安装。
安装依赖项：

npm install

构建服务器：

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

clj-kondo