docvet — MCP-сервер для Claude Code: что делает и установка
Проверяет docstring в Python-проекте: ищет пропуски, расхождения с кодом и признаки устаревания. Пригодится для ревью документации.
claude mcp add docvet -- uvx docvetЧто делает docvet
docvet даёт агенту проверки документации Python: наличие docstring, полноту разделов и согласованность с кодом. Он ищет пропущенные Raises, Returns, Yields, параметры и атрибуты, проверяет примеры и перекрёстные ссылки. Отдельные правила анализируют изменения сигнатур, тела функций и импортов через историю Git.
Сервер также запускает проверки покрытия пакета и диагностику рендеринга через Griffe. Результаты можно разделить на ошибки и предупреждения в pyproject.toml, а порог покрытия и правила отказа настроить отдельно. Для проверок Griffe нужна зависимость docvet[griffe]; без неё такие проверки будут недоступны.
Какие задачи решает
- найти функции без docstring
- сверить разделы документации со структурой кода
- обнаружить устаревшие docstring после изменений в Git
- проверить покрытие пакета и наличие
__init__.py - выявить предупреждения Griffe при рендеринге
Примеры запросов агенту
- Проверь docstring во всём Python-проекте и покажи пропущенные разделы.
- Найди документацию, которая могла устареть после изменений в Git.
- Проверь покрытие документации и ошибки Griffe, если зависимость доступна.
Как установить docvet
Командой платформы
claude mcp add docvet -- uvx docvetuvx запускает команду с именем пакета; если в README она другая — uvx --from docvet <команда>
Командой платформы
codex mcp add docvet -- uvx docvetuvx запускает команду с именем пакета; если в README она другая — uvx --from docvet <команда>
Файл настроек
{
"mcpServers": {
"docvet": {
"command": "uvx",
"args": [
"docvet"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from docvet <команда>
Файл настроек
{
"servers": {
"docvet": {
"type": "stdio",
"command": "uvx",
"args": [
"docvet"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from docvet <команда>
Командой платформы
gemini mcp add docvet uvx docvetuvx запускает команду с именем пакета; если в README она другая — uvx --from docvet <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о docvet
Как установить docvet в Claude Code?
Выполните claude mcp add docvet -- uvx docvet.
Что делает docvet?
Он проверяет наличие и полноту docstring в Python-коде, сопоставляет документацию со структурой функций и ищет признаки устаревания по истории Git.
Какие проверки входят в docvet?
В сервере есть проверки наличия, полноты, свежести, рендеринга и видимости пакета. Всего описано 32 правила в 5 группах проверок.
