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