io.github.rog0x/lint MCP Server

An MCP server for style check, naming, and complexity analysis tailored for AI agents. It performs analysis via regex and text parsing without AST libraries, exposing tooling for code-quality evaluation within the Model Context Protocol ecosystem.

🛠️ Key Features

Code style checks with configurable rules
Indentation, line length, trailing whitespace, final newline enforcement
Quote consistency and semicolon handling
Regex-based analysis suitable for MCP workflows
No external AST dependencies required

🚀 Use Cases

Validate AI agent code against style guidelines
Integrate with MCP-enabled CI pipelines
Quick quality gates for model-context tooling
Enforce naming and complexity heuristics in agent scripts

⚡ Developer Benefits

Lightweight, regex-based linting within MCP server
Easy to extend with additional rules
Clear, readable readme excerpt for quick onboarding
TypeScript-based implementation aligned with MCP tooling

⚠️ Limitations

Analysis relies on text parsing, not ASTs
May require rule customization for project-specific styles
Focused on style, naming, and basic complexity checks only

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