Enables AI assistants to interact with a Minecraft server using the Model Context Protocol (MCP).
A Model Context Protocol (MCP) integration for Minecraft that enables AI assistants to interact with a Minecraft server. This integration allows AI models to observe and interact with the Minecraft world through a bot.
⚠️ Note: Currently only tested on macOS/Linux. Windows compatibility is not guaranteed.
Download and Setup Minecraft Server
~/minecraft-server/
)server.jar
file in this directoryserver.jar
fileInstall and Configure MCP Integration
Quick Install (Recommended):
npx -y @smithery/cli install mcp-minecraft --client claude
Follow the CLI prompts to complete the setup.
Or Manual Setup:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-minecraft": {
"command": "npx",
"args": [
"-y",
"mcp-minecraft@latest",
"--server-jar",
"/absolute/path/to/minecraft-server/server.jar"
]
}
}
}
⚠️ Replace
/absolute/path/to/minecraft-server/server.jar
with your actual server.jar path
Launch Claude Desktop
Connect to Server
Minecraft Server
localhost:25565
The integration exposes these MCP resources:
minecraft://bot/location
- Current bot position in the worldminecraft://bot/status
- Bot connection statusAvailable MCP tools:
chat
- Send chat messages to the serverjump
- Make the bot jumpmoveForward
- Make the bot move forwardmoveBack
- Make the bot move backwardturnLeft
- Make the bot turn leftturnRight
- Make the bot turn rightplaceBlock
- Place a block at specified coordinatesdigBlock
- Break a block at specified coordinatesgetBlockInfo
- Get information about a block at specified coordinatesselectSlot
- Select a hotbar slot (0-8)getInventory
- Get contents of bot's inventoryequipItem
- Equip an item by name to specified destinationgetStatus
- Get bot's current status (health, food, position, etc.)getNearbyEntities
- Get list of nearby entities within rangeattack
- Attack a nearby entity by nameuseItem
- Use/activate the currently held itemstopUsingItem
- Stop using/deactivate the current itemlookAt
- Make the bot look at specific coordinatesfollowPlayer
- Follow a specific playerstopFollowing
- Stop following current targetgoToPosition
- Navigate to specific coordinatesMCP Connection Failed
Server Won't Start
Can't Connect to Server
~/Library/Logs/Claude/mcp*.log
Contributions, big or small, are welcome!
This project is licensed under the MIT License - see the LICENSE file for details.
Provides AI assistants with comprehensive access to a Plex Media Server.
Access real-time gaming data across popular titles like League of Legends, TFT, and Valorant, offering champion analytics, esports schedules, meta compositions, and character statistics.
Provides AI agents with read-only access to SignalK marine data systems, enabling queries of vessel navigation data, AIS targets, and system alarms.
An MCP server for programmatic control of smartscreen.tv displays via HTTP and MCP commands, with YouTube integration.
Multimodal MCP server for generating images, audio, and text with no authentication required
generate lyrics, song and background music(instrumental)
A philosophical reasoning system combining OpenEnded Philosophy with the Non-Axiomatic Reasoning System (NARS) for advanced analysis and synthesis.
PiAPI MCP server makes user able to generate media content with Midjourney/Flux/Kling/Hunyuan/Udio/Trellis directly from Claude or any other MCP-compatible apps.
Provides current time and timezone conversion capabilities using IANA timezone names, with automatic system timezone detection.
AI-driven venture capitalist agents powered by Octagon Private Markets' real-time intelligence.