openzim-mcp — MCP-сервер для Claude Code: офлайн-доступ к ZIM-архивам
Даёт ИИ-агенту читать архивы ZIM — Wikipedia, Wiktionary, Stack Exchange — без интернета. Пригодится, если нужен поиск и навигация по локальной базе знаний.
claude mcp add --env OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> --transport stdio openzim-mcp -- uvx openzim-mcpЧто делает openzim-mcp
Сервер поднимает локальный доступ к файлам формата ZIM из библиотеки Kiwix. Внутри восемь инструментов: zim_query, zim_search, zim_get, zim_get_section, zim_browse, zim_metadata, zim_links, zim_health. Есть режим Simple с одним инструментом для запросов на естественном языке. Пресеты под тип архива сами настраивают выдачу под Wikipedia или Stack Exchange, а разбор ссылок отвечает на вопрос «что ссылается сюда».
Работает по stdio и по Streamable HTTP. Поиск идёт с подсказками и по нескольким архивам сразу, выдача кешируется и разбивается на страницы. Входные данные проверяются, есть защита от обхода путей. Есть ресурсы MCP с уведомлениями об изменениях.
Без файла .zim серверу нечего читать — сначала положите архив в каталог, на который он смотрит. Установка идёт через uv tool install openzim-mcp или pip install openzim-mcp, для Docker — образ ghcr.io/cameronrye/openzim-mcp. Контейнер по умолчанию говорит по stdio, так что docker run -i подключается к клиенту как обычный бинарник.
Какие задачи решает
- найти статью в офлайн-архиве Wikipedia
- вытащить оглавление и разделы страницы ZIM
- посмотреть, какие статьи ссылаются на текущую
- искать сразу по нескольким архивам ZIM
- проверить целостность и метаданные архива
Примеры запросов агенту
- Найди в архиве статью про фотосинтез и перескажи её
- Покажи разделы статьи про климат из
wikipedia_en_climate_change_mini_2024-06.zim - Что ссылается на эту статью в архиве?
Как установить openzim-mcp
Командой платформы
claude mcp add --env OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> --transport stdio openzim-mcp -- uvx openzim-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>
Командой платформы
codex mcp add openzim-mcp --env OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> -- uvx openzim-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>
Файл настроек
{
"mcpServers": {
"openzim-mcp": {
"command": "uvx",
"args": [
"openzim-mcp"
],
"env": {
"OPENZIM_MCP_TOOL_MODE": "<OPENZIM_MCP_TOOL_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>
Файл настроек
{
"servers": {
"openzim-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"openzim-mcp"
],
"env": {
"OPENZIM_MCP_TOOL_MODE": "<OPENZIM_MCP_TOOL_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>
Командой платформы
gemini mcp add -e OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> openzim-mcp uvx openzim-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о openzim-mcp
Как установить openzim-mcp в Claude Code?
Выполните claude mcp add --env OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> --transport stdio openzim-mcp -- uvx openzim-mcp.
Что делает openzim-mcp?
Даёт агенту структурированный офлайн-доступ к архивам ZIM: поиск, чтение статей, навигацию по разделам и разбор ссылок.
Что нужно для работы openzim-mcp?
Хотя бы один файл .zim в каталоге, который вы указали серверу. Для запуска через uvx нужен установленный uv.
