@rog0x/mcp-lint-tools

Code linting and style checking tools for AI agents, exposed as an MCP (Model Context Protocol) server.

All analysis is performed via regex and text parsing — no AST libraries required.

Tools

check_code_style

Check code style issues with configurable rules:

• Indentation — tabs vs spaces, configurable indent size

• Line length — flag lines exceeding a maximum length

• Trailing whitespace — detect trailing spaces/tabs

• Final newline — require a newline at end of file

• Quotes — enforce single or double quote consistency

• Semicolons — enforce always or never semicolon usage

check_naming_conventions

Analyze identifier naming conventions:

• Detect camelCase, PascalCase, snake_case, UPPER_CASE

• Language-aware rules for TypeScript, JavaScript, Python, Go

• Flag mixed conventions within the same identifier kind

• Suggest fixes with automatic name conversion

analyze_complexity

Measure code complexity metrics:

• Cyclomatic complexity per function

• Lines per function count

• Nesting depth measurement

• Configurable thresholds for flagging

find_dead_code

Detect potential dead code:

• Unused variables — declared but never referenced

• Unreachable code — statements after return/throw/break

• Empty catch blocks — silently swallowed errors

• Commented-out code — blocks of commented code

• TODO/FIXME/HACK — annotation comments

analyze_imports

Analyze import statements:

• Unused imports — imported names not referenced in code

• Import ordering — enforce group ordering (builtin > external > internal > relative)

• Duplicate imports — same module imported multiple times

• Circular dependency hints — basic detection of potential cycles

Related MCP server: code-guardian

Installation

npm install
npm run build

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "lint-tools": {
      "command": "node",
      "args": ["path/to/mcp-lint-tools/dist/index.js"]
    }
  }
}

Development

npm install
npm run build
npm start

License

MIT