Minecraft Wiki MCP

Minecraft Wiki MCP

一个用于浏览官方 Minecraft Wiki 的 MCP 服务！

警告

这是 v2 —— 一次完整的 Python 重写。如果你正在从 v1（TypeScript）升级，请参阅下方的迁移说明。

提示

公共托管实例：你可以直接连接到该服务的公共托管实例 https://minecraft-wiki-mcp.goett.top/mcp，无需在本地安装或运行任何东西！有关说明，请参阅下方的 Streamable HTTP 传输。

功能

• Wiki 搜索 —— 查找有关 Minecraft 结构、实体、物品和方块的信息
• 页面摘要 —— 获取页面的简介以及目录，以便进一步浏览
• 章节访问 —— 以原始 wikitext 形式读取特定章节
• 完整页面内容 —— 当你需要全部内容时，获取整个页面
• 分类浏览 —— 浏览 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. 输入 https://minecraft-wiki-mcp.goett.top/mcp 作为服务 URL。

• ChatGPT 网站（自定义应用）： 在启用开发者模式后，ChatGPT 原生支持连接自定义 MCP 服务（即使是免费套餐）：

  1. 打开 ChatGPT Settings -> Apps -> Advanced Settings 并启用 Developer Mode。
  2. 返回并创建一个新应用。
  3. 输入 https://minecraft-wiki-mcp.goett.top/mcp 作为 MCP 服务 URL 以进行连接。

配置

通过环境变量配置主机、端口和安全性：

变量	默认值	描述
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/loopback 上托管时默认为 true，否则为 false（例如在 VPS 上绑定到 0.0.0.0 时）。
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	读取特定章节的原始 wikitext
minecraft_wiki_resolve_redirect	检查标题是否重定向并找到目标

分类

工具	描述
minecraft_wiki_get_categories	获取页面的分类，或按前缀浏览分类
minecraft_wiki_get_category_members	列出分类中的所有页面

推荐工作流

为获得最佳结果，大模型应遵循以下模式：

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

致谢

特别感谢 stone-brick 开发了出色的 minecraft-wiki-MDifier 库！该库将复杂的 Minecraft wikitext 转换为干净、易读的 Markdown，这不仅改善了 MCP 服务的解析结果，还显著节省了大模型的 token 使用量。感谢你的帮助以及构建这个出色的库！

从 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	返回 wikitext 而不是剥离后的 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	已重命名

其他破坏性变更：

• 通过 MINECRAFT_WIKI_API_URL 环境变量配置，而不是 --api-url 命令行标志
• 运行时：Python 3.12+ 配合 uv，而不是 Node.js
• 内容是原始 wikitext，而不是剥离 HTML 的文本