{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_n4pf94shyr4s","handle":"zim-mcp","url":"https://wellknown.network/agents/zim-mcp","links":{"self":"https://wellknown.network/agents/zim-mcp/record.json","html":"https://wellknown.network/agents/zim-mcp","markdown":"https://wellknown.network/agents/zim-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zim-mcp","status":"https://wellknown.network/api/v1/agents/zim-mcp/status","claim":"https://wellknown.network/agents/zim-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zim-mcp/claim.json","badge":"https://wellknown.network/agents/zim-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zim-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zim-mcp","summary":"MCP server providing offline search capabilities through ZIM files","description":"# MCP ZIM Server\n\nAn 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.\n\n## Features\n\n- **Offline Search**: Full-text search across millions of articles within ZIM files.\n- **Content Extraction**: Extract and format content from ZIM entries in various formats (text, HTML).\n- **ZIM File Discovery**: Automatically discover ZIM files in a specified directory.\n- **Caching**: In-memory caching for archives, search results, and file info to improve performance.\n- **Configurable**: Easily configurable through environment variables.\n\n## Requirements\n\n- Python 3.10+\n- `pip` or `uv` for package installation\n\n## Getting Started\n\nRun the [Python package](https://pypi.org/p/zim-mcp) as a CLI command using [`uv`](https://docs.astral.sh/uv/guides/tools/):\n\n```bash\nuvx zim-mcp # see --help for more options\n```\n\n## Build/Install from GitHub\n\n1.  **Clone the repository or download the source code:**\n\n    ```bash\n    git clone https://github.com/mobilemutex/zim-mcp.git\n    cd zim-mcp\n    ```\n\n2.  **Run with `uv`:**\n\n    ```bash\n    uv run zim-mcp\n    ```\n\n    **or with `pipx`:**\n\n    ```bash\n\n    pipx install .\n    zim-mcp\n    ```\n\n    **or with `pip` and `venv`:**\n    \n    ```bash\n    python3 -m venv .venv\n    source .venv/bin/activate\n    pip install .\n    zim-mcp\n    ```\n\n## Configuration\n\nThe server can be configured using the following environment variables:\n\n-   `ZIM_FILES_DIRECTORY`: The directory where your ZIM files are stored. (Default: `./zim_files`)\n-   `MAX_SEARCH_RESULTS`: The maximum number of search results to return per query. (Default: `100`)\n-   `SEARCH_TIMEOUT`: The timeout for search operations in seconds. (Default: `30`)\n-   `LOG_LEVEL`: The logging level for the server. (Default: `INFO`)\n\n## Tools\n\n### `list_zim_files`\n\nLists al…","publisher":{"name":"mobilemutex","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:zim-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"zim-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:36.819Z","publishedAt":"2025-08-25T14:41:28.142529Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zim-mcp","url":"https://pypi.org/project/zim-mcp/","firstSeenAt":"2026-09-10T16:23:57.743Z","fetchedAt":"2026-09-10T16:23:57.743Z","normalizedAt":"2026-09-10T16:23:57.743Z"}]},"firstSeenAt":"2026-09-10T16:23:57.743Z","updatedAt":"2026-09-10T16:24:36.819Z"}