Zim
A MCP server that enables AI models to access and search ZIM format knowledge bases offline
What is Zim?
Zim is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that enables ai models to access and search zim format knowledge bases offline
A MCP server that enables AI models to access and search ZIM format knowledge bases offline
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A MCP server that enables AI models to access and search ZIM
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx zimConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Zim
The Zim MCP Server enables AI models to search and read ZIM-format knowledge bases entirely offline, without any internet connection. ZIM is the compressed archive format used by Kiwix to distribute offline copies of Wikipedia, Project Gutenberg, Stack Overflow, and hundreds of other reference collections. By connecting Claude or another AI assistant to local ZIM files, you get instant, private access to massive knowledge bases that work even without connectivity.
Prerequisites
- Python 3.9 or later installed
- uv package manager installed for dependency management
- One or more ZIM files downloaded from the Kiwix Library at library.kiwix.org
- An MCP client such as Claude Desktop
- Git installed to clone the repository
Clone the repository
Clone the zim-mcp-server repository to your local machine.
git clone https://github.com/ThinkInAI-Hackathon/zim-mcp-server.git
cd zim-mcp-serverInstall dependencies with uv
Use uv to create a virtual environment and install all required Python dependencies from the lock file.
uv syncDownload ZIM files from the Kiwix Library
Visit library.kiwix.org and download the ZIM files for the knowledge bases you want offline access to (e.g., Wikipedia in English, Stack Overflow). Place them in a directory you will reference in the config.
Configure your MCP client
Add the zim-mcp-server to your Claude Desktop configuration. Pass the path to your ZIM files directory as an argument to server.py. On Windows, use double backslashes in paths.
{
"mcpServers": {
"zim-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/zim-mcp-server",
"run",
"server.py",
"/path/to/zim/files"
]
}
}
}Restart Claude Desktop and verify
Restart Claude Desktop. Ask Claude to list available ZIM files — the list_zim_files tool will return all ZIM archives found in the directory you configured.
Zim Examples
Client configuration
Claude Desktop configuration for the Zim MCP Server with paths to the cloned repository and your ZIM files directory.
{
"mcpServers": {
"zim-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/zim-mcp-server",
"run",
"server.py",
"/Users/yourname/zim-files"
]
}
}
}Prompts to try
Example prompts for searching and reading from offline ZIM knowledge bases.
- "List all the ZIM knowledge bases I have available offline."
- "Search Wikipedia for 'quantum entanglement' and summarize the top results."
- "Get the full Wikipedia article on Artificial Intelligence from my local ZIM file."
- "Search Stack Overflow for 'Python async await' and show me the first 5 results."
- "Find information about the French Revolution in the Wikipedia ZIM and give me the key dates."Troubleshooting Zim
list_zim_files returns an empty list
Verify that the path you passed as the argument to server.py actually contains .zim files. Check that the path is absolute and correctly escaped in your JSON config. You can test by running 'ls /path/to/zim/files/*.zim' in a terminal.
uv command not found when Claude Desktop starts the server
Install uv by following the instructions at docs.astral.sh/uv/getting-started/installation. After installation, ensure uv is in a system PATH that GUI applications can access (on macOS, add it to /etc/paths or /usr/local/bin).
search_zim_file returns no results for queries I expect to find
Ensure you are passing the full file path to the zimFilePath parameter, not just the filename. Also check that your query matches the language and content of the ZIM file — a French Wikipedia ZIM will not match English queries well.
Frequently Asked Questions about Zim
What is Zim?
Zim is a Model Context Protocol (MCP) server that mcp server that enables ai models to access and search zim format knowledge bases offline It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Zim?
Follow the installation instructions on the Zim GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Zim?
Zim works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Zim free to use?
Yes, Zim is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Zim Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Zim? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Zim in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Zim?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.