Enables AI agents to see and control Minecraft by interacting with Fabric clients and Paper servers through screenshots, commands, and API access.
Also known as uxplima/craftwire
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.10.0
- Last commit
- Nov 14, 2026
- License
- MIT
What is Craftwire MCP?
Craftwire enables AI agents to see and control Minecraft by interacting with Fabric clients and Paper servers through screenshots, commands, and API access.
Summary generated from the project's README
About Craftwire MCP server
Craftwire provides a bridge for AI agents to interact with Minecraft through Fabric clients and Paper servers. It allows an agent to view the game via screenshots and a free camera, while also enabling control over GUIs, chat, and the HUD. For those managing Paper servers, the server offers access to console commands, Bukkit API JavaScript execution, world editing, and event monitoring. It can even identify performance bottlenecks by profiling which specific plugins or methods cause lag.
Developers set up the server using npx commands to configure clients like Claude Desktop, Cursor, or Windsurf. The system requires specific jar files placed in the mods or plugins folders of the game. While it typically runs over stdio, you can use npx craftwire serve to host the hub over HTTP with a token for multiple clients. If no game is currently running, the client_process tool can launch a hidden Minecraft instance that automatically downloads necessary files to join a singleplayer world or a local development server.
What you can do with it
- 1Automated plugin developmentAn AI agent can run plugin tests using JSON scenarios via the command line.
- 2Server performance profilingIdentify which specific mod or method is causing the game to lag.
Written from the project's README. Every use case is checked against a quote from it.
How to install Craftwire MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Craftwire MCP in Claude Code
$ claude mcp add craftwire -- npx -y craftwireInstall Craftwire MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"craftwire": {
"command": "npx",
"args": [
"-y",
"craftwire"
]
}
}
}Install Craftwire MCP in VS Code
.vscode/mcp.json
{
"servers": {
"craftwire": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"craftwire"
]
}
}
}Install Craftwire MCP in VS Code CLI
$ code --add-mcp '{"name":"craftwire","type":"stdio","command":"npx","args":["-y","craftwire"]}'Install Craftwire MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"craftwire": {
"command": "npx",
"args": [
"-y",
"craftwire"
]
}
}
}Install Craftwire MCP in Codex
$ codex mcp add craftwire -- npx -y craftwireInstall Craftwire MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.craftwire] command = "npx" args = ["-y", "craftwire"]
Install Craftwire MCP in Gemini CLI
$ gemini mcp add -s user craftwire npx -- -y craftwireInstall Craftwire MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"craftwire": {
"command": "npx",
"args": [
"-y",
"craftwire"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableuxplima/craftwire is public and reachablegithub.com/uxplima/craftwire ↗Pass
- Package names this repository as its sourcecraftwire names uxplima/craftwire as sourcenpmjs.com/package/craftwire ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/uxplima/craftwire ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from craftwirePass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcraftwire
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 computer
npx 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:
{ "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'smods/folder, with Fabric API.craftwire-paper-<version>.jar: put it in a Paper server'splugins/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
Craftwire MCP questions
How do I add Craftwire MCP to Claude Code?
Run claude mcp add craftwire -- npx -y craftwire in your terminal. Add --scope user to make it available in every project.
How do I add Craftwire MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I set up Craftwire with my AI client?
You can use the command npx craftwire setup followed by your client name (e.g., codex, gemini, claude-desktop) to automatically add the entry to your MCP config.
Can I use Craftwire if I don't have a Minecraft game currently running?
Yes, the client_process tool can start a hidden client that downloads Minecraft and Fabric automatically to join a dev server or open a singleplayer world.
How do I install the agent on the game side?
Download the appropriate JAR files from the releases page and place the Fabric agent in your mods/ folder and the Paper agent in your server's plugins/ folder.
Can multiple AI clients connect to the same hub?
By default, you should use one client at a time, but you can run npx craftwire serve to share a single hub between several clients using MCP over HTTP.