https://github.com/Bigsy/clj-kondo-MCP
https://github.com/Bigsy/clj-kondo-MCP
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/Bigsy/clj-kondo-MCP
- Owner: Bigsy
- License: mit
- Created: 2025-03-29T22:00:44.000Z (17 days ago)
- Default Branch: main
- Last Pushed: 2025-03-30T19:13:04.000Z (17 days ago)
- Last Synced: 2025-03-30T19:26:04.502Z (17 days ago)
- Language: JavaScript
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - clj-kondo MCP Server - Provides clj-kondo linting for Clojure/ClojureScript/EDN via the Model Context Protocol (MCP) (Table of Contents / Developer Tools)
- awesome-mcp-servers - clj-kondo MCP Server - Provides clj-kondo linting for Clojure/ClojureScript/EDN via the Model Context Protocol (MCP) (Table of Contents / Developer Tools)
- awesome-mcp-servers - clj-kondo-MCP - Clojure linter (Community Servers)
README
# clj-kondo MCP Server [](https://badge.fury.io/js/clj-kondo-mcp)
A Model Context Protocol (MCP) server that provides clj-kondo linting capabilities for Clojure/ClojureScript/EDN files. Handy for Claude code and desktop where there are no built in linting capabilities. You may want to consider editing your CLAUDE.md asking it to lint after editing.
## Features
- Lint Clojure files via MCP tool calls
- Supports all clj-kondo analysis capabilities
- Optional explicit configuration directory support
## Installation
### Quick Install
```bash
npx clj-kondo-mcp
```
or IDE config
```json
{
"mcpServers": {
"clj-kondo": {
"command": "npx",
"args": ["clj-kondo-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
```
### Manual Installation
1. Install clj-kondo:
Make sure you have [clj-kondo](https://github.com/clj-kondo/clj-kondo) installed and available on your system PATH. See the [installation instructions](https://github.com/clj-kondo/clj-kondo/blob/master/doc/install.md) for your platform.
2. Install dependencies:
```bash
npm install
```
3. Build the server:
```bash
npm run build
```
## Usage
### Running the Server
```bash
node build/index.js
```
### MCP Tool Calls
The server provides one tool:
**lint_clojure** - Lint Clojure/ClojureScript/EDN content
Parameters:
```json
{
"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 for stricter agentic code analysis
}
```
The `file` parameter accepts:
- A single file path (e.g. "/path/to/src/my_file.clj")
- A directory path (e.g. "/path/to/src") - will lint all .clj, .cljs and .cljc files recursively
- A classpath string - will lint all Clojure files in the classpath
- For Leiningen projects: Use output of `lein classpath`
- For deps.edn projects: Use output of `clojure -Spath`
**Note**: Both file and configDir parameters must be absolute paths since the MCP server runs as a separate process. Relative paths will not work correctly.
By default, clj-kondo will automatically look for configuration in the `.clj-kondo` directory in the current and parent directories. You can override this by specifying the `configDir` parameter to point to a specific configuration directory.
For more information about clj-kondo configuration, see the [official documentation](https://github.com/clj-kondo/clj-kondo/blob/master/doc/config.md).
## Configuration
Add to your MCP settings file (for Cline, located at `~/Library/Application Support/Code - Insiders/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`):
```json
{
"mcpServers": {
"clj-kondo": {
"command": "npx",
"args": ["clj-kondo-mcp"],
"disabled": false,
"autoApprove": []
}
}
}
```
For manual builds, use:
```json
{
"mcpServers": {
"clj-kondo": {
"command": "node",
"args": ["build/index.js"],
"disabled": false,
"autoApprove": []
}
}
}
```
### Build
```bash
npm run build
```
### Watch Mode
```bash
npm run dev
```