mcpzim

ローカルのLLMエージェントがオフラインのZIMファイル群を利用できるようにするMCPサーバーです。ZIMファイルを格納したディレクトリを指定すると、サーバーは以下の処理を行います。

• 何があるかをインベントリ化し（list_libraries）、読み込まれた内容に基づいて集約された機能（一般知識、医学知識、地図/経路案内）をアドバタイズします。

• すべてのZIMにわたる検索および記事取得機能（search、get_article、get_main_page）を公開します。

• --routingオプション付きでビルドされたstreetzim ZIMを検出すると、plan_driving_route、geocode、route_from_placesを追加で公開します。これにより、ローカルエージェントが「AからBまでのドライブ経路を教えて」と尋ねると、道路ごとの指示、距離、推定時間を取得できるようになります。

設計原則は**日和見的な機能（opportunistic capability）**です。WikipediaのZIMを1つから始めればWikipediaサーバーとして機能します。mdwiki_en_all_*.zimを追加すれば医学的な質問にも回答できるようになります。streetzimのZIMを追加すれば、そのZIMがカバーする地域のドライブ経路も計画できるようになります。ツールは基盤となるデータが存在する場合にのみ表示されるため、エージェントのツールリストがサーバーの能力について嘘をつくことはありません。

インストール

Python 3.10以上が必要です。

pip install mcpzim               # once published
# or, from a checkout:
pip install -e .

libzimはネイティブホイールです。macOS（x86_64/arm64）、Linux（x86_64/aarch64、glibcおよびmusl）、Windows x64向けのビルド済みホイールが存在します。その他のプラットフォームではpipがソースからビルドするため、C++ツールチェーンが必要になります。

Related MCP server: kiwix-mcp

実行

ZIMファイルを1つのディレクトリに配置し、以下を実行します。

export ZIM_DIR=~/zims
mcpzim                           # stdio transport (Claude Desktop / Code)
mcpzim ~/zims/wikipedia.zim ~/zims/streetzim_ma.zim   # explicit paths
mcpzim --transport streamable-http --host 0.0.0.0 --port 8765  # LAN

~/.config/claude-desktop/claude_desktop_config.json（またはお使いのMCPクライアントの同等ファイル）に追加します。

{
  "mcpServers": {
    "mcpzim": {
      "command": "mcpzim",
      "env": { "ZIM_DIR": "/Users/me/zims" }
    }
  }
}

ツール

常に利用可能:

経路データを含むstreetzim ZIMが読み込まれている場合にのみ表示:

ルーター内のコスト/ヒューリスティックはstreetzimのJSビューアと完全に一致します： edge_cost = distance_m / (speed_kmh / 3.6) および heuristic = haversine / (100/3.6)。そのため、結果はブラウザ内のビューアが生成するものと同一になります。

サポートされているZIM

型検出はスキャン時に実行され、ファイル名のプレフィックス、ZIMのName / Tags / Creator / Publisherメタデータ、およびアーカイブ内の署名エントリを組み合わせて使用します。標準でサポートされるもの：

• Wikipedia — wikipedia_*.zim（Creator: Wikipedia、タグwikipedia）。

• mdwiki — WikiProjectMed Foundationによるmdwiki_*.zim（タグmdwiki / medical）。

• streetzim — アーカイブ内のrouting-data/graph.binまたはmap-config.jsonの存在によって検出されます。

• generic — その他すべて（*.zimは引き続き提供されますが、ZimKind.GENERICのデフォルトツールセットのみが適用されます）。

セッション例

> list_libraries
{"zims": [
   {"path": ".../wikipedia_en_all_nopic_2026-03.zim", "kind": "wikipedia", ...},
   {"path": ".../mdwiki_en_all_2026-03.zim", "kind": "mdwiki", ...},
   {"path": ".../streetzim_ma.zim", "kind": "streetzim", "has_routing": true, ...}
 ],
 "by_kind": {"wikipedia": 1, "mdwiki": 1, "streetzim": 1},
 "capabilities": ["encyclopedia", "general_knowledge", "geocode",
                  "get_article", "list_libraries", "maps", "medical",
                  "plan_route", "search"]}

> route_from_places {"origin": "Boston Common", "destination": "Fenway Park"}
{"origin_resolved": {"name": "Boston Common", "lat": 42.3554, "lon": -71.0655, ...},
 "destination_resolved": {"name": "Fenway Park", "lat": 42.3467, "lon": -71.0972, ...},
 "distance_km": 3.27, "duration_min": 9.4,
 "roads": [
    {"name": "Beacon Street", "distance_m": 412.3, "duration_s": 44.0},
    ...
 ],
 "turn_by_turn": ["Beacon Street for 0.41 km (~0.7 min)", ...],
 "polyline": [[42.3554, -71.0655], ...]}

モバイル

正直な回答：python-libzimにはiOS用のホイールがないため、現在iOS上でネイティブPython + libzimを実行するのは困難です。C++のlibzimを自分でクロスコンパイルする必要があります。努力の少ない順に実用的な選択肢を挙げます：

1. LANブリッジ（最も簡単、現在動作可能）。 ネットワーク上のマシン（またはRaspberry Pi）で mcpzim --transport streamable-http --host 0.0.0.0 を実行します。モバイルエージェントをそこに向けてください。ZIMデータはホームサーバー上に留まり、スマートフォンは機能豊富なMCPエンドポイントを参照するだけです。これはモバイルコードなしで現在動作します。

2. Termux経由のAndroid。 Termuxで pkg install python clang && pip install mcpzim を実行すると、libzimがソースからビルドされます。デバイス上で実行し、stdio（ローカルエージェントプロセス用）またはlocalhost上のstreamable-httpを介してアプリ内クライアントに公開します。

3. Swift/Kotlinへの移植。 SZRG v2ルーティング形式とZIMアクセス層はどちらも意図的に単純化されています。（Kiwix iOSが既に行っているように）Swiftバインディングを通じてC++のlibzimを呼び出すSwift MCPモジュールを作成すれば、このPythonサーバーと同じツールインターフェースを公開できます。これが、プロセス内MCPツールプロバイダーを求めるiOSチャットアプリにとって最善の道です。

4. Kiwix-serveブリッジ。 Kiwixモバイルアプリは既にローカルHTTPサーバーを埋め込んでいます。ZIMを直接開く代わりに http://localhost:port/ にプロキシする代替のmcpzimモードがあれば、Kiwixが動作する場所ならどこでも機能します。（未実装 — プルリクエスト歓迎。）

開発

pip install -e '.[dev]'
pytest

テストに実際のZIMファイルは必要ありません。ルーティングテストは mcpzim.routing.encode_graph_v2 を使用してメモリ内で小さなSZRG v2グラフを構築し、ライブラリテストは分類器を直接実行します。

ライセンス

MIT。