MCP server providing offline search capabilities through ZIM files
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"zim-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# MCP ZIM Server An MCP (Model Context Protocol) server that provides offline search and content extraction capabilities for Large Language Models (LLMs) using ZIM files. This server allows LLMs to perform deep research and access information in offline environments, replacing the need for live web access. ## Features - **Offline Search**: Full-text search across millions of articles within ZIM files. - **Content Extraction**: Extract and format content from ZIM entries in various formats (text, HTML). - **ZIM File Discovery**: Automatically discover ZIM files in a specified directory. - **Caching**: In-memory caching for archives, search results, and file info to improve performance. - **Configurable**: Easily configurable through environment variables. ## Requirements - Python 3.10+ - `pip` or `uv` for package installation ## Getting Started Run the [Python package](https://pypi.org/p/zim-mcp) as a CLI command using [`uv`](https://docs.astral.sh/uv/guides/tools/): ```bash uvx zim-mcp # see --help for more options ``` ## Build/Install from GitHub 1. **Clone the repository or download the source code:** ```bash git clone https://github.com/mobilemutex/zim-mcp.git cd zim-mcp ``` 2. **Run with `uv`:** ```bash uv run zim-mcp ``` **or with `pipx`:** ```bash pipx install . zim-mcp ``` **or with `pip` and `venv`:** ```bash python3 -m venv .venv source .venv/bin/activate pip install . zim-mcp ``` ## Configuration The server can be configured using the following environment variables: - `ZIM_FILES_DIRECTORY`: The directory where your ZIM files are stored. (Default: `./zim_files`) - `MAX_SEARCH_RESULTS`: The maximum number of search results to return per query. (Default: `100`) - `SEARCH_TIMEOUT`: The timeout for search operations in seconds. (Default: `30`) - `LOG_LEVEL`: The logging level for the server. (Default: `INFO`) ## Tools ### `list_zim_files` Lists al…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.