ZIM RAG MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ZIM RAG MCP Server
MCP (Model Context Protocol) server for reading .zim archives and exposing
search/content retrieval tools over stdio.
What This Server Provides
ZIM file discovery from a configured directory
Metadata and article listing tools
Title/url search
Article content retrieval
TF-IDF based RAG retrieval over extracted article chunks
Related MCP server: ZIM MCP Server
Project Layout
server.py- MCP stdio server and tool/resource handlerszim_reader.py- binary ZIM parser and article extractionrag_engine.py- chunking + TF-IDF retrieval enginerequirements.txt- Python dependencies
Requirements
Python 3.10+
A directory containing one or more
.zimfiles
Install dependencies:
pip install -r requirements.txtRun Locally
From this folder (MCPs/ZIM_MCP):
python server.pyEnvironment variable:
ZIM_DIRECTORY(optional): directory containing.zimfilesdefault: current working directory
Example:
set ZIM_DIRECTORY=E:\ZIMs
python server.pyMCP Client Configuration
Use script execution (not -m MCPs.ZIM_MCP), because this package does not
define __main__.py.
Example (Windows / Cline-style JSON)
{
"mcpServers": {
"ZIM-MCP": {
"type": "stdio",
"command": "C:\\Program Files\\Python310\\python.exe",
"args": [
"e:\\ZIM-MCP\\MCPs\\ZIM_MCP\\server.py"
],
"env": {
"ZIM_DIRECTORY": "e:\\ZIMs"
},
"timeout": 60,
"disabled": false,
"autoApprove": []
}
}
}Tools
list_zim_filesList
.zimfiles discovered inZIM_DIRECTORY.
zim_infoReturn metadata and namespace counts for a specific ZIM file.
zim_searchSearch by title/url substring.
zim_get_articleReturn article title/url/content.
zim_rag_retrieveReturn top semantic matches from TF-IDF retrieval.
zim_list_articlesPaginated article list with namespace filter.
Resource URIs
zim://{file}/infozim://{file}/article/{url}zim://{file}/search/{query}zim://{file}/rag/{query}
Notes
RAG indexing now gracefully handles small/stopword-heavy corpora and returns empty results instead of crashing.
ZIM cluster parsing supports common compression formats, including Zstandard (via Python
zstandardpackage).
Troubleshooting
Server starts but no files found
Verify
ZIM_DIRECTORYpoints to the folder that contains.zimfiles.
No module named ...errorsReinstall deps:
pip install -r requirements.txt
MCP fails to launch from client
Use the full script path in
args(...\\server.py), not-m MCPs.ZIM_MCP.
Author
Garland Glessner (gglessner@gmail.com)
License
GNU General Public License v3 (GPLv3)
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Your personal library, readable by AI agents: durable snapshots, hybrid search, 46 MCP tools.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Ingest, manage, and retrieve documents for RAG-powered AI applications
Private, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI models to access and search offline Wikipedia and other knowledge bases stored in ZIM format files. Provides intelligent content retrieval, structured browsing, advanced search capabilities, and metadata extraction for comprehensive offline knowledge access.8385 PyPI154MIT
- AlicenseNot gradedqualityDmaintenanceEnables large language models to directly access and search content in ZIM files, allowing offline question answering and information retrieval from resources like Wikipedia.22MIT
- AlicenseNot gradedqualityDmaintenanceEnables offline CRUD and semantic search on Wikipedia ZIM archives via MCP tools for reading, writing, editing, deleting, and searching articles.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides offline search and retrieval of Wikipedia articles using Kiwix .zim files, enabling LLMs to access full Wikipedia content without internet.3MIT