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