kiwix-wiki

The Kiwix Wiki MCP Server exposes an interface to query and fetch content from offline Wikipedia and related ZIM libraries via Kiwix. It connects to a locally running Kiwix server (default at http://localhost:8080) and offers tools to search for articles, retrieve full article content, and list available offline libraries. Start by ensuring your Kiwix server is up with ZIM files loaded, then run the MCP server (npm start or node build/main.js). Once running, you can use the provided tools to interact with the offline content. The primary tools are: 1) search_wiki to find articles by a query, returning a list of results; 2) get_article to fetch the full content of a selected article by URL or path; and 3) list_libraries to enumerate the offline libraries currently available on the Kiwix server. The server defaults to Kiwix at http://localhost:8080 but can be pointed to another instance by editing the KIWIX_SERVER_BASE setting if needed.

Prerequisites:

• Node.js and npm installed on your system
• A Kiwix server running locally with ZIM files accessible (http://localhost:8080 by default)

Install and run:

1. Clone/download the project
2. Install dependencies:

npm install

3. Build the project (if needed):

npm run build

4. Start the MCP server:

npm start

Alternatively, run directly the built entry point:

node build/main.js

Configure the Kiwix server URL if you’re using a non-default location by setting KIWIX_SERVER_BASE in the environment or editing main.ts as described in the configuration section.

Notes and tips:

• Ensure the Kiwix server is running and accessible at the configured base URL (default http://localhost:8080).
• If you see "Failed to search the wiki" or connection errors, verify the Kiwix server URL/port and that the required ZIM files are loaded.
• The configuration is easily adjustable via the KIWIX_SERVER_BASE environment variable to point to a different Kiwix instance.
• If you update or change libraries, re-run the server to reflect new content availability.
• The MCP client example in the README demonstrates how to configure the kiwix-wiki server in an MCP client; adapt paths and ports as needed for your environment.