Minecraft Wiki MCP

Minecraft Wiki MCP

公式の Minecraft Wiki を閲覧するための MCP サーバーです！

警告

これは v2 です — Python による完全な書き直しです。v1（TypeScript）からアップグレードする場合は、以下の移行ノートを参照してください。

ヒント

公開ホスト版インスタンス: このサーバーの公開ホスト版インスタンスには、ローカルに何もインストールしたり実行したりすることなく、https://minecraft-wiki-mcp.goett.top/mcp に直接接続できます！手順については、以下のStreamable HTTP トランスポートを参照してください。

機能

• Wiki 検索 — Minecraft の構造物、エンティティ、アイテム、ブロックに関する情報を検索します
• ページ要約 — ページの導入部と、さらに辿るための目次を取得します
• セクションアクセス — 特定のセクションを生のウィキテキストとして読み取ります
• ページ全体のコンテンツ — すべてが必要なときにページ全体を取得します
• カテゴリ閲覧 — Wiki のカテゴリとその所属ページを探索します
• リダイレクト解決 — リダイレクトを辿って正規のページを見つけます
• 多言語サポート — Minecraft Wiki の任意の言語版に接続します

要件

• Python 3.12+
• uv（推奨パッケージマネージャー）

インストール

uv でのクイックスタート

# Clone the repository
git clone https://github.com/L3-N0X/Minecraft-Wiki-MCP.git
cd Minecraft-Wiki-MCP

# Install dependencies
uv sync

# Run the server
uv run minecraft-wiki-mcp

pip を使用する場合

pip install -e .
minecraft-wiki-mcp

設定

Claude Desktop

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "minecraft-wiki": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/Minecraft-Wiki-MCP",
        "run", "minecraft-wiki-mcp"
      ]
    }
  }
}

Claude Code

claude mcp add minecraft-wiki -- uv --directory /path/to/Minecraft-Wiki-MCP run minecraft-wiki-mcp

多言語サポート

デフォルトでは、サーバーは英語版 Wiki（https://minecraft.wiki/api.php）に接続します。 別の言語を使用するには、MINECRAFT_WIKI_API_URL 環境変数を設定します：

{
  "mcpServers": {
    "minecraft-wiki": {
      "command": "uv",
      "args": [
        "--directory", "/path/to/Minecraft-Wiki-MCP",
        "run", "minecraft-wiki-mcp"
      ],
      "env": {
        "MINECRAFT_WIKI_API_URL": "https://de.minecraft.wiki/api.php"
      }
    }
  }
}

Streamable HTTP トランスポート

デフォルトでは、サーバーは stdio トランスポート（stdin/stdout 経由の通信）を使用します。 リモートアクセスやマルチクライアントアクセスには、Streamable HTTP トランスポートを使用できます：

# Start the HTTP server (default: http://127.0.0.1:8000/mcp)
uv run minecraft-wiki-mcp --transport streamable-http

その後、クライアントを HTTP エンドポイントに接続します。たとえば、Claude Code を使用して公開ホスト版インスタンスに接続するには：

claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp

またはローカルサーバーの場合：

claude mcp add --transport http minecraft-wiki http://localhost:8000/mcp

主要プラットフォームから公開インスタンスへの接続

公開ホスト版 URL https://minecraft-wiki-mcp.goett.top/mcp は、リモート MCP 接続やカスタムアプリをサポートする主要プラットフォームで簡単に追加できます：

• Claude Code:

  claude mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp
  

• Claude（Web およびデスクトップ）と Perplexity:

  1. 設定/カスタマイズページを開きます（例：Claude の Customize -> Connectors）。
  2. HTTP/SSE トランスポートを使用してリモートサーバーを追加するオプションを選択します。
  3. サーバー URL として https://minecraft-wiki-mcp.goett.top/mcp を入力します。

• ChatGPT ウェブサイト（カスタムアプリ）: ChatGPT は、開発者モードが有効になっている場合、カスタム MCP サーバーへのネイティブ接続をサポートしています（無料プランでも可能です）：

  1. ChatGPT の Settings -> Apps -> Advanced Settings を開き、Developer Mode を有効にします。
  2. 戻って新しいアプリを作成します。
  3. MCP サーバー URL として https://minecraft-wiki-mcp.goett.top/mcp を入力して接続します。

設定

環境変数を使用してホスト、ポート、セキュリティを構成します：

変数	デフォルト	説明
MINECRAFT_WIKI_HOST	127.0.0.1	HTTP サーバーをバインドするホスト
MINECRAFT_WIKI_PORT	8000	HTTP サーバーのポート
MINECRAFT_WIKI_API_URL	https://minecraft.wiki/api.php	MediaWiki API エンドポイント
MINECRAFT_WIKI_ENABLE_SECURITY	自動	DNS リバインディング保護（Host/Origin ヘッダーチェック）を適用します。localhost/ループバックでホストしている場合はデフォルトで true、それ以外の場合（例：VPS で 0.0.0.0 にバインドする場合）は false になります。
MINECRAFT_WIKI_ALLOWED_HOSTS	自動	許可される Host ヘッダーのカンマ区切りリスト。（例：mcp.example.com:*,123.45.67.89:*）。セキュリティが有効な場合にのみ機能します。
MINECRAFT_WIKI_ALLOWED_ORIGINS	自動	許可される Origin ヘッダーのカンマ区切りリスト。（例：https://mcp.example.com:*）。セキュリティが有効な場合にのみ機能します。

利用可能なツール

検索とナビゲーション

ツール	説明
minecraft_wiki_search	名前でページを検索します（アイテム、ブロック、エンティティ、構造物）
minecraft_wiki_get_page	ページの概要 + セクション一覧、またはページ全体の内容を取得します
minecraft_wiki_get_section	特定のセクションの生のウィキテキストを読み取ります
minecraft_wiki_resolve_redirect	タイトルがリダイレクトされるかどうかを確認し、リダイレクト先を見つけます

カテゴリ

ツール	説明
minecraft_wiki_get_categories	ページのカテゴリを取得するか、プレフィックスでカテゴリを閲覧します
minecraft_wiki_get_category_members	カテゴリ内のすべてのページを一覧表示します

推奨ワークフロー

最良の結果を得るために、LLM は次のパターンに従うことをお勧めします:

1. 検索 — minecraft_wiki_search で適切なページを見つけます
2. 要約 — minecraft_wiki_get_page で導入部と利用可能なセクションを確認します
3. 深掘り — minecraft_wiki_get_section で特定のセクションを読み取ります

開発

# Install dependencies
uv sync

# Run with the MCP Inspector for interactive testing
uv run mcp dev src/minecraft_wiki_mcp/server.py

# Syntax check
uv run python -m py_compile src/minecraft_wiki_mcp/server.py

謝辞

素晴らしい minecraft-wiki-MDifier ライブラリを開発してくださった stone-brick 氏に特別な感謝を捧げます！このライブラリは、複雑な Minecraft のウィキテキストをクリーンで読みやすい Markdown に変換し、MCP サーバーの解析結果を改善するだけでなく、LLM のトークン使用量を大幅に節約します。ご協力とこの素晴らしいライブラリの構築に感謝いたします！

v1 からの移行

v2 は TypeScript から Python への完全な書き直しです。主な変更点:

v1 ツール	v2 ツール	備考
MinecraftWiki_searchWiki	minecraft_wiki_search	名前変更
MinecraftWiki_getPageSummary	minecraft_wiki_get_page	セクション一覧が含まれるようになりました
MinecraftWiki_getPageContent	minecraft_wiki_get_page	include_all_content=true を使用してください
MinecraftWiki_getSectionsInPage	minecraft_wiki_get_page	セクション一覧がレスポンスに含まれます
MinecraftWiki_getPageSection	minecraft_wiki_get_section	ストリップされた HTML ではなくウィキテキストを返します
MinecraftWiki_getCategoriesForPage	minecraft_wiki_get_categories	title パラメータを渡してください
MinecraftWiki_listAllCategories	minecraft_wiki_get_categories	prefix パラメータを渡してください
MinecraftWiki_listCategoryMembers	minecraft_wiki_get_category_members	名前変更
MinecraftWiki_resolveRedirect	minecraft_wiki_resolve_redirect	名前変更

その他の破壊的変更:

• 設定は --api-url CLI フラグではなく MINECRAFT_WIKI_API_URL 環境変数で行います
• ランタイム: Node.js ではなく Python 3.12+ と uv
• コンテンツは HTML を除去したテキストではなく生のウィキテキストです