项目简介
这是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为大型语言模型(LLM)客户端(如Claude Desktop等)提供访问和浏览官方 Minecraft Wiki 内容的能力。LLM客户端可以通过调用该服务器提供的工具来搜索、获取页面内容、查看分类等信息,从而增强其在Minecraft领域的知识和互动能力。
主要功能点
- Wiki搜索: 允许LLM搜索Minecraft中的结构、实体、物品、方块等信息。
- 页面导航: 提供获取Wiki页面摘要、完整内容以及查看可用章节列表的功能。
- 章节访问: 支持直接获取Wiki页面中特定章节的详细内容。
- 分类浏览: 能够列出Wiki上的所有分类,并获取某个分类下的所有页面。
- 多语言支持: 可通过配置连接到不同语言版本的Minecraft Wiki API。
安装步骤
安装该服务器需要Node.js环境。
- 克隆项目仓库: 使用 Git 命令克隆项目的源代码到本地。
- 进入项目目录: 进入刚刚克隆下来的 'Minecraft-Wiki-MCP' 文件夹。
- 安装依赖: 运行 'npm install' 命令下载项目所需的所有库和模块。
- 构建项目: 运行 '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)正确添加到其配置中。
基本使用方法
- 确保您已经按照上述步骤完成了服务器的安装和构建。
- 在您的MCP客户端中配置好该Minecraft Wiki服务器的信息(如上所述)。
- 启动您的MCP客户端。客户端会自动按照配置启动Minecraft Wiki MCP服务器,并与之建立连接。
- 一旦连接建立,您的LLM就可以通过调用服务器公开的工具(如搜索、获取页面等)来与Minecraft Wiki进行交互,获取所需信息。
推荐LLM进行信息查询的流程是:
- 使用搜索工具('MinecraftWiki_searchWiki')查找您感兴趣的物品、实体等的基本名称,获得页面标题。
- 使用获取摘要工具('MinecraftWiki_getPageSummary')获取找到页面的摘要信息和章节列表。
- 使用获取章节工具('MinecraftWiki_getPageSection')根据章节列表获取特定章节的详细内容。
LLM也可以根据需要直接调用其他工具,例如列出所有分类或获取某个分类下的成员页面。
信息
分类
网页与API