zim-mcp-server

zicojiao/zim-mcp-server

3.2

If you are the rightful owner of zim-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol server for reading and searching ZIM files, which are used for offline storage of Wikipedia and other reference content.

Tools
3
Resources
0
Prompts
0

ZIM MCP Server

⚠️ Experimental Warning

This is an experimental version that has only been tested on WSL2. The installation and usage instructions below are specifically for WSL2 environment.

A Model Context Protocol server for reading and searching ZIM files. ZIM is a file format developed by Kiwix for offline storage of Wikipedia and other reference content.

Installation (WSL2)

  1. Install dependencies:
pnpm install
  1. Build the project:
pnpm run build
  1. Prepare ZIM files: Download ZIM files from Kiwix Library and place them in a directory, e.g., /path/to/zim

Usage

Configuration for Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "zim-mcp-server": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "node /path/to/zim-mcp-server/build/index.js /path/to/zim"
      ]
    }
  }
}

Example:

{
  "mcpServers": {
    "zim-mcp-server": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "node /home/username/Code/zim-mcp-server/build/index.js /home/username/Code/zim"
      ]
    }
  }
}

Replace /path/to/zim-mcp-server with your project path and /path/to/zim with your ZIM files directory path.

Available Tools

  1. list-zim-files: List all ZIM files in allowed directories
  2. search-zim-file: Search within ZIM file content
    • Required: zimFilePath, query
    • Optional: limit (default: 10), offset (default: 0)
  3. get-zim-entry: Get detailed content of a specific entry
    • Required: zimFilePath, entryPath
    • Optional: maxContentLength (default: 10000)

License

MIT