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

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