Craftwire

Name: Craftwire
Author: UXPLIMA

本地服务

github.com游戏娱乐42 周前更新

代码仓库访问官网

关于 Craftwire

Craftwire 是 MCP 服务 hub，可让 AI Agent 查看和控制 Minecraft Fabric 客户端及 Paper 服务端。它结合游戏内交互、服务端管理、插件测试、机器人和性能分析，并支持插件与模组添加工具。

主要功能

01查看截图、HUD 和游戏界面
02发送聊天、操作输入并点击界面
03运行 Paper 命令并检查世界
04使用 JSON 场景测试插件
05使用寻路机器人和性能分析

适用场景

01通过 AI Agent 与 Minecraft 交互
02调试 Paper 插件和服务端错误
03运行可重复的插件场景测试
04查找模组或插件的性能瓶颈

MCP 相关

将 Minecraft 客户端和服务端操作作为工具提供给 MCP 客户端。可通过 stdio 运行，也可通过带令牌的 HTTP 共享 hub。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "uxplima-craftwire": {
      "command": "npx",
      "args": [
        "-y",
        "craftwire"
      ]
    }
  }
}

启动命令npx -y craftwire

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

安装包

npmcraftwire0.10.0stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

craftwire

此软件包是 Craftwire 的 MCP 服务（中心）。它让 AI Agent 看见并操控 Minecraft：

在 Fabric 客户端上：截图、自由视角、读取和点击 GUI、聊天、输入及 HUD。
在 Paper 服务端上：控制台命令、通过 JavaScript 调用 Bukkit API、读取和编辑世界及其图像、触发的所有事件、归类为 Bug 的异常、日志和插件控制。
插件开发循环、能自行寻路的服务端 Bot，以及以 JSON 场景编写的插件测试（npx craftwire test）。
性能分析：找出导致服务端或游戏卡顿的插件或 Mod、监听器和方法，以及单个方法的精确调用时间。
插件和 Mod 可以添加自己的工具。

Minecraft 26.2 和 26.3 · Fabric 客户端 · Paper 服务端 · MIT · 作者：UXPLIMA

设置 AI 客户端

npx craftwire setup            # lists the clients found on this computer
npx craftwire setup codex      # or: gemini, antigravity, cursor, windsurf, vscode, claude-desktop

setup 会将 craftwire 条目添加到客户端的 MCP 配置中。它会保留其他条目不变，并先将文件备份为 .bak。对于 Codex 和 Gemini CLI，它还会安装 Craftwire 的技能。--dry-run 会显示更改内容，但不写入文件。

Claude Code 使用插件：

/plugin marketplace add uxplima/craftwire
/plugin install craftwire@uxplima

其他任何 MCP 客户端均通过 stdio 运行：

{ "mcpServers": { "craftwire": { "command": "npx", "args": ["-y", "craftwire"] } } }

在 Windows 上，请使用 "command": "cmd", "args": ["/c", "npx", "-y", "craftwire"]。

添加游戏端组件

从 Releases 获取两个 JAR 文件：

craftwire-agent-fabric-<version>.jar：将其放入 Fabric 配置文件的 mods/ 文件夹，并安装 Fabric API。
craftwire-paper-<version>.jar：将其放入 Paper 服务端的 plugins/ 文件夹。

两者都会自行连接到中心。中心仅监听 127.0.0.1，并将令牌写入 ~/.craftwire/hub.json。一次只使用一个搭配 Craftwire 的 AI 客户端；或者运行 npx craftwire serve（通过带令牌的 HTTP 提供 MCP 服务），让多个客户端共享同一个中心。

没有打开游戏？client_process 工具可以启动由中心自行运行的隐藏客户端。它首次使用时会从官方服务器下载 Minecraft 和 Fabric，然后加入你的开发服务端（该服务端需要设置 online-mode=false），或打开一个单人游戏世界。

故障排查：npx craftwire doctor。添加 --server <folder> 还可以检查服务端文件夹。

文档、工具和协议：https://github.com/uxplima/craftwire

支持 Markdown

登录后评论