# openzim-mcp

Даёт ИИ-агенту читать архивы ZIM — Wikipedia, Wiktionary, Stack Exchange — без интернета. Пригодится, если нужен поиск и навигация по локальной базе знаний.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 146
- Автор: cameronrye
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cameronrye/openzim-mcp
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/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` подключается к клиенту как обычный бинарник.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `OPENZIM_MCP_TOOL_MODE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
codex mcp add openzim-mcp --env OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> -- uvx openzim-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "openzim-mcp": {
            "command": "uvx",
            "args": [
                "openzim-mcp"
            ],
            "env": {
                "OPENZIM_MCP_TOOL_MODE": "<OPENZIM_MCP_TOOL_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
gemini mcp add -e OPENZIM_MCP_TOOL_MODE=<OPENZIM_MCP_TOOL_MODE> openzim-mcp uvx openzim-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openzim-mcp <команда>

## Когда брать
- найти статью в офлайн-архиве Wikipedia
- вытащить оглавление и разделы страницы ZIM
- посмотреть, какие статьи ссылаются на текущую
- искать сразу по нескольким архивам ZIM
- проверить целостность и метаданные архива

## Примеры запросов агенту
- Найди в архиве статью про фотосинтез и перескажи её
- Покажи разделы статьи про климат из `wikipedia_en_climate_change_mini_2024-06.zim`
- Что ссылается на эту статью в архиве?

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md