mkdocs-mcp — MCP-сервер для Claude Code: что делает и как установить
Открывает статьи и структуру MkDocs как ресурсы MCP для ИИ-ассистентов. Пригодится, когда нужно дать агенту прямой доступ к локальной документации.
claude mcp add mkdocs-mcp -e MKDOCS_PROJECT_PATH=<MKDOCS_PROJECT_PATH> -- uvx mkdocs-mcpЧто делает mkdocs-mcp
Сервер переносит проект MkDocs в формат ресурсов Model Context Protocol. Из-за ограничений движка MkDocs команда mkdocs serve здесь не подходит: вместо неё процесс сборки и запуск MCP берёт на себя скрипт mkdocs-mcp.
Для запуска в системе нужен пакетный менеджер uv. Путь к каталогу документации задаётся через переменную окружения MKDOCS_PROJECT_PATH или ключ --mkdocs-project-path.
В файле mkdocs.yml обязательно объявляется плагин mcp. Конфигурация позволяет настроить способ именования ресурсов (src_file, dst_url или title), отдавать исходный Markdown вместо конвертации HTML, а также объединять статьи по папкам. Без добавления плагина в конфиг сервер документацию не отдаст.
Какие задачи решает
- Передать статьи базы знаний MkDocs в контекст ассистента через протокол MCP
- Настроить выдачу документации единым файлом или отдельными папками
- Использовать исходный Markdown вместо конвертации готового HTML
- Подключить локальную документацию к Claude Desktop через WSL
Примеры запросов агенту
- Прочитай раздел об установке из ресурсов MkDocs и найди системные требования.
- Найди в подключённой документации страницу с описанием конфигурации плагина.
Как установить mkdocs-mcp
Командой платформы
claude mcp add mkdocs-mcp -e MKDOCS_PROJECT_PATH=<MKDOCS_PROJECT_PATH> -- uvx mkdocs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mkdocs-mcp <команда>
Командой платформы
codex mcp add mkdocs-mcp --env MKDOCS_PROJECT_PATH=<MKDOCS_PROJECT_PATH> -- uvx mkdocs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mkdocs-mcp <команда>
Файл настроек
{
"mcpServers": {
"mkdocs-mcp": {
"command": "uvx",
"args": [
"mkdocs-mcp"
],
"env": {
"MKDOCS_PROJECT_PATH": "<MKDOCS_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mkdocs-mcp <команда>
Файл настроек
{
"servers": {
"mkdocs-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"mkdocs-mcp"
],
"env": {
"MKDOCS_PROJECT_PATH": "<MKDOCS_PROJECT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mkdocs-mcp <команда>
Командой платформы
gemini mcp add -e MKDOCS_PROJECT_PATH=<MKDOCS_PROJECT_PATH> mkdocs-mcp uvx mkdocs-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mkdocs-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mkdocs-mcp
Как установить mkdocs-mcp в Claude Code?
Выполните команду claude mcp add mkdocs-mcp -e MKDOCS_PROJECT_PATH=<MKDOCS_PROJECT_PATH> -- uvx mkdocs-mcp, подставив путь к папке с файлом mkdocs.yml.
Что делает mkdocs-mcp?
Он собирает проект MkDocs и раздаёт его страницы языковым моделям в виде MCP-ресурсов через транспорт stdio.
Почему сервер запускается через отдельный скрипт, а не через mkdocs serve?
Архитектура MkDocs не позволяет переопределить стандартную команду mkdocs serve, поэтому запуск и сборку документации выполняет отдельный скрипт mkdocs-mcp.
