🚀 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": []
}
}
}
手动安装
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的输出
- 对于 Leiningen 项目：使用
⚠️ 重要提示
由于 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