can-craft
Check if the bot can craft a specific item with current inventory
LABSCO SUMMARY
It gives an agent hands in a world where mistakes cost nothing.
The 22 tools cover the loop a player actually runs — find the blocks, dig them, craft the result, smelt what needs heat — rather than a build API that skips to the finished structure, so the model has to plan the way you would. read-chat and send-chat make it a participant instead of a process: you can redirect it from inside the game.
What it is
A local server that joins a bot to a running Minecraft server and exposes 22 tools for it: movement and flight, inventory and equipment, block placing and digging, block and entity search, crafting and smelting, and chat in both directions.
What you get
- Move the bot — move-to-position with a range and timeout, move-in-direction for a duration, fly-to, jump, look-at, get-position.
- Handle what it carries: list-inventory, find-item, equip-item into a chosen slot.
- Change the world: place-block with a face direction, dig-block, get-block-info, and find-blocks to locate nearby blocks of a type within a distance.
- Craft and smelt — list-recipes for what is makeable right now, can-craft for a specific item, get-recipe for the details, craft-item, and smelt-item with a fuel and a furnace position.
- Find the nearest entity of a type within a range (find-entity).
- Talk to the players around it: read-chat returns recent messages, send-chat posts one.
- Check which game mode the bot is in (detect-gamemode).
Requirements
A Minecraft server the bot can join, and Node.js on the machine. The documented configuration joins localhost on port 25565 as ClaudeBot; --host, --port and --username point it elsewhere. Apache-2.0.
Setup effort
One command — npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
USE CASES
01
Getting materials gathered while you do something else
Send the bot to find a block type, dig it and report what it is carrying.
02
Crafting something without looking up the recipe
Check whether it is makeable with what is on hand, read the recipe, and make it.
03
Building a structure from a description
Place blocks at coordinates, moving and re-equipping as the build goes up.
04
Taking instructions from players in the game
Read what people are saying in chat and act on it, answering in the same channel.
05
Smelting ore into usable material
Find the furnace, load it with input and fuel, and take the output.
22 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
craft-item
Craft an item using a crafting recipe
detect-gamemode
Detect the gamemode on game
dig-block
Dig a block at the specified position
equip-item
Equip a specific item
find-blocks
Find one or more nearby blocks of a specific type
find-entity
Find the nearest entity of a specific type
find-item
Find a specific item in the bot's inventory
fly-to
Make the bot fly to a specific position
get-block-info
Get information about a block at the specified position
get-position
Get the current position of the bot
get-recipe
Get detailed information about a specific recipe
jump
Make the bot jump
list-inventory
List all items in the bot's inventory
list-recipes
List all available crafting recipes the bot can make with current inventory
look-at
Make the bot look at a specific position
move-in-direction
Move the bot in a specific direction for a duration
move-to-position
Move the bot to a specific position
place-block
Place a block at the specified position
read-chat
Get recent chat messages from players
send-chat
Send a chat message in-game
smelt-item
Smelt items using a furnace-like block
BEFORE YOU INSTALL
What to know first
Tools you get
22 tools when we connected.
Requires
- npx on PATH
- Node.js
CONTEXT COST
Light Standing cost
Rated by the size of the 22 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"minecraft-mcp-server": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host",
"localhost",
"--port",
"25565",
"--username",
"ClaudeBot"
]
}
}
}npx
TERMINAL
npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
