# MCP Lint Server

An MCP server that provides MCP server quality checking as a tool.

[![MCP](https://img.shields.io/badge/MCP-compatible-blue.svg)](https://modelcontextprotocol.io)
[![PyPI](https://img.shields.io/pypi/v/mcp-lint-server.svg)](https://pypi.org/project/mcp-lint-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## What It Does

This MCP server exposes three tools that let AI agents validate MCP server implementations:

1. **`lint_mcp_server`** -- Lint a file or directory for MCP quality issues
2. **`lint_code_snippet`** -- Validate a code snippet before committing
3. **`check_mcp_schema`** -- Validate an MCP tool inputSchema definition

## Quick Start

```bash
pip install mcp-lint-server
```

### Claude Desktop Config

```json
{
  "mcpServers": {
    "mcp-lint": {
      "command": "python",
      "args": ["-m", "mcp_lint_server.server"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add mcp-lint-server -- python -m mcp_lint_server.server
```

## Tools

### `lint_mcp_server`

Scans Python source code for schema violations, security anti-patterns, protocol issues, and code quality problems. Returns a quality score (0-100) with specific issues and fix suggestions.

### `lint_code_snippet`

Validates a code snippet by pasting it directly. Useful for quick checks before committing.

### `check_mcp_schema`

Validates an MCP tool inputSchema definition, checking for required fields and valid property definitions.

## Why This Matters

The MCP ecosystem is exploding. Hundreds of new servers are built every week. But there is zero quality tooling. This server lets AI agents themselves enforce quality standards on MCP server code.

## Related

- [mcp-lint](https://github.com/ZachDreamZ/mcp-lint) -- CLI version (free)
- [MCP Lint Pro](https://shadowcraft41.gumroad.com/l/mcp-lint-pro) -- Runtime validation ($9)

## License

MIT