OpenZIM MCP Server

Example Use Cases

• 1

  Search and retrieve article content from offline ZIM archives with relevance-ranked results and pagination.

• 2

  Fetch detailed entry content and metadata (including smart path resolution and cached path mappings) for use as model context.

• 3

  Explore namespace structures, extract article headings and links, and perform filtered searches or autocomplete suggestions against ZIM knowledge bases.

Description

OpenZIM MCP transforms static ZIM files into an intelligent Model Context Protocol server, enabling LLMs to browse, search, and retrieve article content, metadata, and relationships. It provides smart retrieval (direct access with automatic fallback and path mapping cache), advanced search and filtering, namespace browsing, and metadata extraction, all with caching and performance optimizations. The project supports two operation modes (Full mode with multiple specialized tools and Simple mode with a single natural-language tool), robust security (path traversal protection and input sanitization), and is designed for high test coverage and observability.