clj-kondo MCP Server

by Bigsy
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides linting capabilities for Clojure, ClojureScript, and EDN files using clj-kondo, supporting analysis of individual files, directories, or classpath content with customizable configuration.

clj-kondo MCP 服务器

一个模型上下文协议 (MCP) 服务器,为 Clojure/ClojureScript/EDN 文件提供 clj-kondo linting 功能。对于没有内置 linting 功能的 Claude 代码和桌面环境来说,这非常方便。您可以考虑编辑 CLAUDE.md 文件,并在编辑后启用 lint 功能。

特征

  • 通过 MCP 工具调用对 Clojure 文件进行 Lint
  • 支持所有 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
  1. 构建服务器:
npm run build

用法

运行服务器

node build/index.js

MCP 工具调用

服务器提供了一个工具:

lint_clojure - Lint Clojure/ClojureScript/EDN 内容

参数:

{ "file": "/absolute/path/to/file.clj", // Must be absolute path - can be a file, directory, or classpath "configDir": "/absolute/path/to/config/dir", // Optional, must be absolute path if provided "level": "warning" // Optional, defaults to error level }

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
-
security - not tested
A
license - permissive license
-
quality - not tested

模型上下文协议服务器为 Clojure/ClojureScript/EDN 文件提供 clj-kondo linting 功能,对于缺少内置 linting 的 Claude 代码和桌面等环境很有用。

  1. Features
    1. Installation
      1. Quick Install
      2. Manual Installation
    2. Usage
      1. Running the Server
      2. MCP Tool Calls
    3. Configuration
      1. Build
      2. Watch Mode
    ID: 3qxm481y72