Servidor MCP clj-kondo

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona funciones de análisis de linting de clj-kondo para archivos Clojure/ClojureScript/EDN. Útil para código Claude y escritorios donde no existen funciones de análisis de linting integradas. Puede considerar editar su CLAUDE.md para solicitarle que realice un análisis de linting después de editarlo.

Características

• Lint archivos Clojure mediante llamadas a la herramienta MCP

• Admite todas las capacidades de análisis de clj-kondo

• Soporte de directorio de configuración explícita opcional

Related MCP server: shadow-cljs-mcp

Instalación

Instalación rápida

npx clj-kondo-mcp

o configuración IDE

{
  "mcpServers": {
    "clj-kondo": {
      "command": "npx",
      "args": ["clj-kondo-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Instalación manual

1. Instalar clj-kondo: Asegúrate de tener clj-kondo instalado y disponible en la ruta de acceso de tu sistema. Consulta las instrucciones de instalación para tu plataforma.

2. Instalar dependencias:

npm install

3. Construir el servidor:

npm run build

Uso

Ejecución del servidor

node build/index.js

Llamadas a herramientas MCP

El servidor proporciona una herramienta:

lint_clojure - Lint Clojure/ClojureScript/EDN contenido

Parámetros:

{
  "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
}

El parámetro file acepta:

• Una única ruta de archivo (por ejemplo, "/ruta/a/origen/mi_archivo.clj")

• Una ruta de directorio (por ejemplo, "/ruta/a/origen") - analizará todos los archivos .clj, .cljs y .cljc de forma recursiva

• Una cadena de ruta de clase: analizará todos los archivos Clojure en la ruta de clase

  • Para proyectos de Leiningen: utilice la salida de lein classpath

  • Para proyectos deps.edn: utilice la salida de clojure -Spath

Nota : Los parámetros de archivo y configDir deben ser rutas absolutas, ya que el servidor MCP se ejecuta como un proceso independiente. Las rutas relativas no funcionarán correctamente.

De forma predeterminada, clj-kondo buscará automáticamente la configuración en el directorio .clj-kondo , tanto en el directorio actual como en el directorio principal. Puede anular esta configuración especificando el parámetro configDir para que apunte a un directorio de configuración específico.

Para obtener más información sobre la configuración de clj-kondo, consulte la documentación oficial .

Configuración

Agregue a su archivo de configuración de MCP (para Cline, ubicado en ~/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": []
    }
  }
}

Para compilaciones manuales, utilice:

{
  "mcpServers": {
    "clj-kondo": {
      "command": "node",
      "args": ["build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Construir

npm run build

Modo reloj

npm run dev