Metadata-Version: 2.4
Name: zimi-mcp
Version: 1.13.0
Summary: Zimi's MCP server and search alone: search and read Wikipedia, Stack Overflow and other ZIM files offline, for AI agents
Author: Eric Pheterson
License: MIT
Project-URL: Homepage, https://github.com/epheterson/Zimi
Project-URL: Documentation, https://github.com/epheterson/Zimi/blob/main/docs/features/api-and-mcp.md
Project-URL: Issues, https://github.com/epheterson/Zimi/issues
Keywords: zim,kiwix,offline,wikipedia,search,mcp,rag,llm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Text Processing :: Indexing
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: libzim>=3.1.0
Requires-Dist: mcp<2.0,>=1.0
Requires-Dist: certifi>=2024.1.1
Provides-Extra: pdf
Requires-Dist: PyMuPDF>=1.23.0; extra == "pdf"
Dynamic: license-file

# zimi-mcp

[Zimi](https://github.com/epheterson/Zimi)'s MCP server and search, without the rest of Zimi. Search and read Wikipedia, Stack Overflow, dev docs and any other ZIM file offline, from Claude, Open WebUI or any MCP client.

```bash
pip install zimi-mcp
zimi-mcp /path/to/zims
```

```json
{
  "mcpServers": {
    "zimi": { "command": "zimi-mcp", "args": ["/path/to/zims"] }
  }
}
```

Three tools by default (search, read a page as Markdown, read one section), about 330 tokens of schema, sized for small local models. `zimi-mcp --tools full` serves every tool Zimi has. Nothing listens on a port.

zimi-mcp is built from the same source as Zimi and released with it, same version. It depends on libzim and mcp only: no web app, downloads, BitTorrent, LAN discovery or desktop window. For text out of the PDFs in zimgit ZIMs, `pip install "zimi-mcp[pdf]"`.

Want the web app, the catalog and the rest? `pip install zimi` is the complete experience and includes the same `zimi-mcp` command. Install one or the other, not both: they share the `zimi` module.

Tools, options and measured numbers: [API & MCP](https://github.com/epheterson/Zimi/blob/main/docs/features/api-and-mcp.md#just-the-basics).
