What it does
docvet checks Python docstrings through a CLI with editor and agent interfaces. It measures docstring presence and coverage, runs structural completeness checks covering raises, returns, yields, parameters, attributes and examples, and reports freshness signals from git diff and blame history. It also reports griffe rendering diagnostics and missing __init__.py files.
It suits reviewing Python code to find undocumented functions, missing or mismatched docstring sections, and docstrings that may need a look after code changes. Its freshness signals only suggest review: code can change without making prose wrong, and simultaneous code and docstring edits can still leave incorrect prose. The publisher's documentation compares it with ruff, interrogate and pydoclint, and notes that results depend on enabled rules and configuration.
Setup means adding a [tool.docvet] section to pyproject.toml, where checks listed in fail-on produce a non-zero exit code when they report findings. Griffe rendering checks need an optional extra. Pre-commit and GitHub Actions integrations are documented.
Limitations and requirements
The griffe rendering checks require an optional griffe extra. A fail-on check that cannot run exits with code 1 unless fail-on-unavailable is set to false. Adding griffe to fail-on can turn a previously passing build red. Structural and freshness checks do not prove that docstrings describe runtime behavior correctly. Some Ruff comparison rules require preview mode and specific rule selection.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.Alberto-Codes/docvet
Docstring quality vetting for Python -- enrichment, freshness, coverage, and presence checks
v3.0.1As shown on registry.modelcontextprotocol.io when we last read it