Minecraft Wiki搜索服务

Minecraft维基MCP

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

[！警告] 这是v2——一个完整的Python重写。如果你从v1（TypeScript）升级，请参阅 迁移说明 在......下面

[！提示] 公共托管实例：您可以直接在以下位置连接到此服务器的公共托管实例 https://minecraft-wiki-mcp.goett.top/mcp 无需在本地安装或运行任何东西！看 可流式传输的HTTP协议 下面是说明。

特征

• Wiki搜索 --查找有关Minecraft结构、实体、项目和块的信息
• 页面摘要 --获取页面介绍和目录以进一步导航
• 区段访问 --将特定部分作为原始维基文本阅读
• 完整页面内容 --需要时检索整个页面
• 类别浏览 --浏览wiki类别及其成员页面
• 重定向解决方案 --按照重定向找到规范页面
• 多语言支持 --连接到Minecraft Wiki的任何语言版本

需求

• Python 3.12+
• 紫外线 （推荐包管理器）

安装

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_config.json:

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

克劳德代码

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

多语言支持

默认情况下，服务器连接到英语维基(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"
      }
    }
  }
}

可流式传输的HTTP协议

默认情况下，服务器使用 标准 传输（通过stdin/stdout进行通信）。 对于远程或多客户端访问，您可以使用 可流式传输的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 mcp add --transport http minecraft-wiki https://minecraft-wiki-mcp.goett.top/mcp
  

• 克劳德（网络和桌面）&困惑:

  1. 打开您的设置/自定义页面（例如，Claude中的自定义->连接器）。
  2. 选择使用添加远程服务器的选项 HTTP/SSE 运输。
  3. 进入 https://minecraft-wiki-mcp.goett.top/mcp 作为服务器URL。

• ChatGPT网站（自定义应用程序）: 启用开发人员模式时，ChatGPT支持本地连接自定义MCP服务器（即使在免费层上）：

  1. 打开ChatGPT 设置 -> 应用 -> 高级设置 并启用 开发者模式.
  2. 返回并创建新应用程序。
  3. 进入 https://minecraft-wiki-mcp.goett.top/mcp 作为要连接的MCP服务器URL。

配置

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

可用工具

搜索和导航

分类

推荐工作流程

为了获得最佳效果，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维基MDifier 图书馆！该库将复杂的Minecraft维基文本转换为干净、易于阅读的Markdown，这不仅改善了MCP服务器的解析结果，还大大节省了LLM的令牌使用。感谢您的帮助和建设这个伟大的图书馆！

从v1迁移

v2是从TypeScript到Python的完全重写。主要变化：

其他重大变化：

• 通过配置 MINECRAFT_WIKI_API_URL env-var而不是 --api-url 命令行标志
• 运行时：Python 3.12+ uv 而不是Node.js
• 内容是原始维基文本，而不是HTML剥离文本