Repository navigation
mcp-lint v1.0
First release of mcp-lint: a CLI that checks MCP servers against Anthropic's guidance on writing tools for agents.
What's in it
mcp-lint: static rules S1–S7 (tool definitions) and probe rules P1–P5 (real calls with a minimal environment), with a token-weighted score per tool and per server.mcp-lint proxy -- <server>: wraps a server without changing it and fixes what the linter flags: paging for large outputs, replacement descriptions from a JSON file, andisErroron error text returned as success.mcp-lint eval: a reproducible before/after experiment that runs Claude Code against real servers.
Does it matter? On 15 held-out tasks across server-filesystem, markitdown-mcp and mcp-server-git (Claude Haiku, 3 runs each), agent success went from 53% to 98% with the proxy's fixes. The worst-scored server gained the most. See eval/REPORT.md for the full numbers and caveats.
Requires Python 3.10+.