io.github.rog0x/lint — MCP Server for AI Agent Code Linting

This MCP server (“io.github.rog0x/lint”) provides style checks and naming/complexity analysis for AI agents. It exposes linting tools via the Model Context Protocol and performs analysis using regex and text parsing (no AST libraries). Tool coverage is focused on code style rules.

🛠️ Key Features

Code linting and style checking for AI agents
Regex and text parsing-based analysis
Configurable style rules, including indentation, line length, and quotes
Checks for trailing whitespace and final newline
Semicolon consistency enforcement

🚀 Use Cases

Enforcing consistent formatting in AI agent codebases
Flagging style violations such as long lines and trailing whitespace
Applying quote and semicolon conventions during development

⚡ Developer Benefits

Centralizes style checks as an MCP (Model Context Protocol) server
Works without AST libraries by using regex/text parsing
Configurable rule parameters (e.g., indentation size, max line length)

⚠️ Limitations

Only regex/text parsing is used for analysis (no AST-based inspection)

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

io.github.rog0x/lint