Best for
- Users who want to experience AI-driven automated players in Minecraft
- Users using Claude Desktop or compatible MCP clients
M
Minecraft MCP Server
Community
MCP server to control a Minecraft character through natural language
- Category
- Other #201 of 230
- Stars
- ★ 776 Popular
- Transport
- stdio (local process)
- Runtime
- Node.js 20.10.0+
- Credentials
- No credential needed
- License
- Apache-2.0
- Last commit
- ⚠
- Tools
- 18
37FMRS · D
This project provides a feature-rich MCP server for Minecraft, integrated with Mineflayer, enabling AI to control characters in real-time. Installation is straightforward, but there are version limitations and potential control risks.
Strongest · Setup experience 12/20 Weakest · Security and permissions 5/20
Why each score
- Reliability 6/20
- Based only on the README, a plausible happy path is described (npx/github start, connect to a LAN Minecraft server, tool list), but no source code, tests, or CI workflow files were provided, so the MCP init/tool-list handshake and tool behavior cannot be verified. Error handling and edge cases are also undocumented; per static calibration uncertainty lowers the score.
- Security and permissions 5/20
- No obvious red-line issue (malware, token leak, exfiltration) is visible, and the README config example contains no real secrets; however, there is no security documentation, no server-side confirmation/least-privilege analysis, and no data-boundary or network-scope description. The 'asks for permissions' note is client-side, not evidence of server-side control, so the score is low but above the red-line band.
- Maintenance 7/20
- The repository is not archived, uses Apache-2.0, shows CI/release badges and a contribution welcome; but there is no verifiable commit/release history, dependency-update or issue-response evidence, and no security-response channel. README claims are untrusted, so maintenance can only be rated as active-looking with governance gaps.
- Documentation 7/20
- README covers prerequisites, a Claude Desktop config example, a command overview, and a contributing link; but it lacks detailed tool parameters, authentication/security notes, limits/cost, troubleshooting, or reviewable test evidence. It is usable but has clear hidden assumptions and troubleshooting gaps.
- Setup experience 12/20
- The README gives an explicit few-step path (run Minecraft, open to LAN, edit claude_desktop_config.json) with an npx example and Node/Minecraft version constraints, which makes the mainstream-client setup look easy; however, no executable verification (CI/tests) is present and platform compatibility is only partially covered, so under static calibration the score is kept below 15 and reduced for uncertainty.
Static review · not runListed 2026-08-07
Read the FMRS scoring method →Fit and risk
What it can accessUses the network
Not for
- Users needing support for the latest Minecraft versions (currently only 1.21.11)
- Users seeking commercial support or official maintenance
Required permissions
- MCP server requires network access to connect to the Minecraft server
- Requires running npx command to start the server
- Requires Minecraft server to be opened to LAN and port (default 25565) accessible
Risks and side effects
- Controlling the Minecraft character can lead to unintended in-game actions, such as breaking blocks or moving incorrectly
- Ambiguous instructions may cause the AI to perform dangerous actions; user supervision is required
- Connection to the Minecraft server may be unstable, causing the bot to disconnect
- Server currently only supports specific versions; upgrading Minecraft may cause incompatibility
Setup
Before you start
Runtime：Node.js 20.10.0+
Ensure Node.js >= 20.10.0 and Git are installed. Run Minecraft, create a singleplayer world and open it to LAN (ESC -> Open to LAN). Install Claude Desktop, open File -> Settings -> Developer -> Edit Config. Add the MCP server configuration to claude_desktop_config.json (see install_config). Restart Claude Desktop; the bot will join the game automatically.
claude_desktop_config.json
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host",
"localhost",
"--port",
"25565",
"--username",
"ClaudeBot"
]
}
}
}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
.vscode/mcp.json
{
"servers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host",
"localhost",
"--port",
"25565",
"--username",
"ClaudeBot"
]
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
Terminal
claude mcp add minecraft -- npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
Run it in a terminal; replace any <…> placeholders with your own values first.
Check that it works
Start Minecraft with the world opened to LAN and fully restart Claude Desktop; if the server boots, the ClaudeBot bot joins the game and tools like get-position and list-inventory appear in the client's tool list — asking the bot for its position confirms the connection.
Troubleshooting
- Ensure the Minecraft world is opened to LAN and the host/port are correct
- Check Node.js version is >= 20.10.0
- Fully quit and restart Claude Desktop to ensure the MCP server loads correctly
- Check Claude Desktop logs for error messages
Things to try
Once connected, you can ask your AI assistant things like:
- Report the bot's current position coordinates
- Find the nearest diamond ore around (100, 64, 200) and dig it
- Move the bot to the village entrance and send a chat message saying hello to nearby players
- List all items in the bot's inventory and equip the iron pickaxe
Tools 18
get-position read-only
Get the current position of the bot
move-to-position writes
Move to specific coordinates
look-at writes
Make the bot look at specific coordinates
jump writes
Make the bot jump
move-in-direction writes
Move in a specific direction for a duration
fly-to writes
Make the bot fly directly to specific coordinates
list-inventory read-only
List all items in the bot's inventory
find-item read-only
Find a specific item in inventory
Show 10 more tools
equip-item writes
Equip a specific item
place-block writes
Place a block at specified coordinates
dig-block destructive
Dig a block at specified coordinates
get-block-info read-only
Get information about a block
find-blocks read-only
Find one or more nearby blocks of a specific type
smelt-item writes
Smelt items using a furnace-like block
find-entity read-only
Find the nearest entity of a specific type
send-chat writes
Send a chat message in-game
read-chat read-only
Get recent chat messages from players
detect-gamemode read-only
Detect the gamemode on game
No matching tools
Use cases
Let AI assistants build structures in Minecraft based on instructions
Let AI assistants explore the world and gather resources
Interact with in-game players via natural language
Supported clients
Claude Desktop
Listed from the project's documentation, not tested by this site.
Overview
This is a Minecraft MCP server powered by the Mineflayer API. It allows AI assistants like Claude to control a Minecraft character in real-time, enabling them to build structures, explore the world, and interact with the game environment through natural language instructions. Currently supports Minecraft version 1.21.11.
Similar servers
Hevy MCP
77 · B
Manage your Hevy workout data from AI assistants via MCP.
Firecrawl MCP Server
75 · B
Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents
BioMCP
75 · B
One binary. One grammar. Evidence from the biomedical sources you already trust.
Compartment
75 · B
Encrypted, fully offline long-term memory for AI agents
Source revision 240c8cec337c Data synced 2026-10-11 Read the FMRS scoring method