mcpField
M
Minecraft

Minecraft

本地服务
github.com游戏娱乐0今天更新
代码仓库访问官网

关于 Minecraft

Minecraft 是面向玩家和服主的 MCP 服务，可通过 WorldAPI 查看和管理 Paper 服务器。工具涵盖游戏状态、配置、日志和实时事件，访问权限由令牌控制。

主要功能

  1. 01查看玩家、世界、方块和实体
  2. 02读取并修改配置与日志
  3. 03查看详细物品栏信息
  4. 04订阅服务器实时事件
  5. 05通过令牌权限控制访问

适用场景

  1. 01查看在线玩家及其位置
  2. 02根据日志排查服务器卡顿
  3. 03给玩家物品或调整时间
  4. 04在玩家加入时接收通知

MCP 相关

它将 Minecraft 服务器的数据和操作作为 MCP 工具提供，并连接 Paper 服务器上的 WorldAPI。支持通过 stdio 或 HTTP 接入 MCP 客户端。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "com-mairwunnx-minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<WORLDAPI_URL>",
        "WORLDAPI_TOKEN": "<WORLDAPI_TOKEN>",
        "WORLDAPI_READ_ONLY": "<WORLDAPI_READ_ONLY>"
      }
    }
  }
}
启动命令npx -y @mairwunnx/minecraft-mcp
需要配置的环境变量
WORLDAPI_URLWorldAPI base URL including /api/v1, such as http://localhost:8110/api/v1. Leave it out for the singleplayer world open on this machine with the WorldAPI mod.
WORLDAPI_TOKEN密钥A WorldAPI token; its permissions decide which tools the agent gets. Leave empty for what anonymous clients may read.
WORLDAPI_READ_ONLY1 hides every tool that changes the server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@mairwunnx/minecraft-mcp4.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

minecraft-mcp

npm MCP Registry Release

🤖 minecraft-mcp 可让 AI Agent 查看和运行你的 Minecraft 服务。向 Claude 提问“谁在线，他们在哪里？”，“服务为什么卡顿？”或“给所有人面包并将时间设为早晨”，它会根据你的世界中的真实数据作答。

它与 AI 客户端一起运行——Claude Desktop、Claude Code、Cursor、VS Code，或任何支持 MCP 的客户端——并与任何 Paper 服务上的 WorldAPI 通信。你提供的令牌决定 Agent 可以执行哪些操作。

Русская версия

你将获得

  • 🧰 73 个工具，用于管理服务、世界、方块、箱子、实体、玩家、排行榜、配方、配置、日志和 Java 脚本。
  • 🎒 深入查看物品栏：每件物品的附魔、耐久度和药水效果，以及潜影盒和收纳袋中的物品。
  • 📜 配置和日志：Agent 可以读取控制台和任何配置文件；使用合适的令牌，还能修改配置值并保留注释。
  • 🔑 令牌允许什么，就能做什么：查看者令牌只显示 29 个只读工具，而只读模式会隐藏所有写入操作。
  • 🙋 “我”就是你：设置你的玩家名称，“我在哪里？”便能正常使用。
  • ⏳ 实时事件：“Steve 加入时通知我”。
  • 🛡️ 安全设计：游戏文本会被明确标记为数据，工具会说明何时会销毁内容，令牌绝不会泄露。
  • 🔌 适用于所有客户端：一键添加到 Claude Desktop，或通过 stdio 或 HTTP 连接任何 MCP 客户端。

开始使用

  1. 在你的 Paper 服务上安装 WorldAPI 3.0.0 或更高版本，并使用 /worldapi token create agent 创建令牌。

  2. 将 minecraft-mcp 添加到你的客户端。在 Claude Desktop 中，打开 minecraft-mcp.mcpb。在 Claude Code 中：

    claude mcp add minecraft -e WORLDAPI_URL=http://localhost:8110/api/v1 -e WORLDAPI_TOKEN=your-token -- npx -y @mairwunnx/minecraft-mcp

  3. 提问“服务状态如何？”。安装页面介绍了 Cursor、VS Code 和 HTTP 的配置方法。

在线试用

我和朋友一起玩的硬核生存服务 Moonlands 运行着 WorldAPI，并允许任何人读取数据。无需令牌即可让 Agent 连接到它：

claude mcp add moonlands -e WORLDAPI_URL=https://minecraft.mairwunnx.com/worldapi/api/v1 -- npx -y @mairwunnx/minecraft-mcp

然后提问“本周谁在 Moonlands 上玩的时间最长？”。

在 Moonlands 游玩：纯原版、强力生物、AI、领地保护。minecraft.mairwunnx.com

文档

其他所有内容都在 wiki 中。

面向玩家和服务器所有者

面向开发者

相关项目

  • Moonlands——所有这些项目运行所在的硬核生存服务器。
  • WorldAPI——用于访问 Paper 服务器世界、玩家和统计数据的 REST 和 WebSocket API。
  • Allay——游戏内的 AI 助手：在聊天中直接使用 /ask 提问。
  • Allay Server——Allay 背后的后端。
  • Mo’Joins——以每位玩家的语言显示加入和退出消息。
  • Mo’Afks——不会阻止夜晚到来的安全挂机模式。
  • Mo’Bosses——以 Boss 形式生成、拥有职业、能力和战利品的怪物。
  • minecraft-exporter——来自 WorldAPI 的 Prometheus 指标。
  • minecraft-grafana——WorldAPI 的 Grafana 仪表板。

🫡 由 Pavel Erokhin（Павел Ерохин）制作，亦称 mairwunnx。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。