Skip to content

mcp-lint v1.0

Choose a tag to compare

@7shep 7shep released this 04 Nov 15:19
· 53 commits to main since this release

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, and isError on 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+.