Craftwire

io.github.UXPLIMAv0.7.2更新于 Oct 7, 2026

See and drive Minecraft: Fabric client, Paper server, bots, plugin tests, profiling.

已验证STDIO仅桌面Developer ToolsSecurity & Monitoring

概览

AI 生成的概览

让 AI 助手看到并操控 Minecraft：控制 Fabric 客户端、在 Paper 服务器执行命令，并分析卡顿。

功能
Craftwire 是 Minecraft 工具链的 MCP 中枢。在 Fabric 客户端上，它提供截图、自由相机、读取和点击 GUI、聊天、输入与 HUD 状态。在 Paper 服务器上，它提供控制台命令、针对 Bukkit API 的 JavaScript、世界读取、编辑与图像、事件捕获、异常归组、日志和插件控制。它还覆盖插件开发循环、可自行寻路的服务端机器人、以 JSON 场景编写的插件测试，以及分析是哪个插件、模组、监听器或方法造成卡顿。插件和模组可以添加自己的工具。
适用场景
当助手需要检查或操作正在运行的 Minecraft 游戏或服务器，而不只是阅读代码时使用：复现和调试插件或模组行为、通过 GUI 和聊天驱动客户端、运行脚本化插件测试，或找出服务器或游戏卡顿的原因。
运行要求
本地 Node.js 运行时，用于通过 npx 运行该 npm 包；还需要对应的游戏侧 jar：把 Fabric 代理模组（连同 Fabric API）放入客户端 mods 文件夹，或把 Paper 插件放入服务器 plugins 文件夹。中枢只监听 127.0.0.1，并把令牌写入 ~/.craftwire/hub.json。client_process 工具会从官方服务器下载 Minecraft 和 Fabric，并要求开发服务器设置 online-mode=false。未声明需要账号或 API 密钥。
安装前请注意
该服务器可以在运行中的游戏和服务器内执行操作：控制台命令、Bukkit API 的 JavaScript、世界编辑、GUI 点击、聊天与输入以及插件控制，因此改动是真实的，可能具有破坏性。~/.craftwire/hub.json 中的中枢令牌属于凭据；除非用 npx craftwire serve 通过 HTTP 共享，否则中枢仅限本机。setup 命令会修改 MCP 客户端配置文件，但会先备份为 .bak 并支持 --dry-run。client_process 工具会从第三方服务器下载游戏文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Craftwire，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Craftwire: let AI agents see and drive Minecraft]

craftwire

This package is the MCP server (hub) of Craftwire. It lets AI agents see and drive Minecraft:

  • On a Fabric client: screenshots, a free camera, reading and clicking GUIs, chat, input and the HUD.
  • On a Paper server: console commands, JavaScript against the Bukkit API, world reads, edits and images, every event that fires, exceptions grouped into bugs, logs and plugin control.
  • A plugin dev loop, server-side bots that find their own path, and plugin tests written as JSON scenarios (npx craftwire test).
  • Profiling: which plugin or mod, listener and method makes the server or the game lag, and exact call times for one method.
  • Plugins and mods can add their own tools.

Minecraft 26.2 & 26.3 · Fabric client · Paper server · MIT · by UXPLIMA

Set up your AI client

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

setup adds the craftwire entry to the client's MCP config. It leaves the other entries alone and backs the file up as .bak first. For Codex and Gemini CLI it also installs Craftwire's skills. --dry-run shows the change without writing it.

Claude Code uses the plugin instead:

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

Any other MCP client runs it over stdio:

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

On Windows, use "command": "cmd", "args": ["/c", "npx", "-y", "craftwire"].

Add the game side

Get both jars from Releases:

  • craftwire-agent-fabric-<version>.jar: put it in your Fabric profile's mods/ folder, with Fabric API.
  • craftwire-paper-<version>.jar: put it in a Paper server's plugins/ folder.

Both connect to the hub on their own. The hub listens on 127.0.0.1 only and writes a token to ~/.craftwire/hub.json. Use one AI client with Craftwire at a time, or run npx craftwire serve (MCP over HTTP with a token) to share one hub between several clients.

No game open? The client_process tool starts a hidden client the hub runs itself. It downloads Minecraft and Fabric from their official servers on first use, then joins your dev server, which needs online-mode=false, or opens a singleplayer world.

Troubleshooting: npx craftwire doctor. Add --server <folder> to check a server folder too.

Docs, tools and the protocol: https://github.com/uxplima/craftwire

来源：hub/README.md，提交 d28dd73

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.7.2最新Oct 7, 2026