项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为大型语言模型(LLM)客户端(如Claude Desktop等)提供访问和浏览官方 Minecraft Wiki 内容的能力。LLM客户端可以通过调用该服务器提供的工具来搜索、获取页面内容、查看分类等信息,从而增强其在Minecraft领域的知识和互动能力。

主要功能点

  • Wiki搜索: 允许LLM搜索Minecraft中的结构、实体、物品、方块等信息。
  • 页面导航: 提供获取Wiki页面摘要、完整内容以及查看可用章节列表的功能。
  • 章节访问: 支持直接获取Wiki页面中特定章节的详细内容。
  • 分类浏览: 能够列出Wiki上的所有分类,并获取某个分类下的所有页面。
  • 多语言支持: 可通过配置连接到不同语言版本的Minecraft Wiki API。

安装步骤

安装该服务器需要Node.js环境。

  1. 克隆项目仓库: 使用 Git 命令克隆项目的源代码到本地。
  2. 进入项目目录: 进入刚刚克隆下来的 'Minecraft-Wiki-MCP' 文件夹。
  3. 安装依赖: 运行 'npm install' 命令下载项目所需的所有库和模块。
  4. 构建项目: 运行 'npm run build' 命令编译服务器代码。构建完成后,可执行文件通常会生成在 'dist' 目录中。

服务器配置

MCP服务器是给MCP客户端(如LLM应用)使用的。MCP客户端需要知道如何启动并连接到这个服务器。这通常通过在客户端的配置文件中指定服务器信息来完成。

配置信息是一个JSON对象,例如:

  • '"minecraft-wiki"': 这是您在客户端中为该服务器指定的唯一名称。
  • '"command"': 指定启动服务器的可执行程序。对于这个项目,通常是 '"node"'。
  • '"args"': 一个字符串数组,包含传递给 'command' 的参数。
    • 第一个参数是服务器脚本的完整路径,例如 '/path/to/your/dist/server.js'。请务必将其替换为实际构建生成的服务器脚本路径
    • 您可以使用可选的 '--api-url' 参数来指定要连接的Minecraft Wiki API地址。例如,'--api-url https://de.minecraft.wiki/api.php' 将连接到德语Wiki。如果不指定此参数,服务器将默认连接到英语Wiki ('https://minecraft.wiki/api.php')。

例如,在某些MCP客户端的配置文件中,您可能会看到类似以下结构的配置(请注意,这只是一个示例结构,具体配置方式取决于您的客户端):

{
  "mcpServers": {
    "minecraft-wiki": {
      "command": "node",
      "args": [
        "/path/to/your/dist/server.js",
        "--api-url",
        "https://de.minecraft.wiki/api.php" 
      ]
    }
    // ... 其他MCP服务器配置
  }
}

请根据您使用的MCP客户端的文档,将上述信息(特别是服务器脚本路径和可选的API URL)正确添加到其配置中。

基本使用方法

  1. 确保您已经按照上述步骤完成了服务器的安装和构建。
  2. 在您的MCP客户端中配置好该Minecraft Wiki服务器的信息(如上所述)。
  3. 启动您的MCP客户端。客户端会自动按照配置启动Minecraft Wiki MCP服务器,并与之建立连接。
  4. 一旦连接建立,您的LLM就可以通过调用服务器公开的工具(如搜索、获取页面等)来与Minecraft Wiki进行交互,获取所需信息。

推荐LLM进行信息查询的流程是:

  1. 使用搜索工具('MinecraftWiki_searchWiki')查找您感兴趣的物品、实体等的基本名称,获得页面标题。
  2. 使用获取摘要工具('MinecraftWiki_getPageSummary')获取找到页面的摘要信息和章节列表。
  3. 使用获取章节工具('MinecraftWiki_getPageSection')根据章节列表获取特定章节的详细内容。

LLM也可以根据需要直接调用其他工具,例如列出所有分类或获取某个分类下的成员页面。

信息

分类

网页与API