Skip to content
Back to search

minecraft-mcp-server

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yuniko-software--minecraft-mcp-server/badge.svg)](/listings/yuniko-software--minecraft-mcp-server)

HTML

<a href="/listings/yuniko-software--minecraft-mcp-server"><img src="/api/listings/yuniko-software--minecraft-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

This bot is designed to be used with Claude Desktop through the Model Context Protocol (MCP).

Run Minecraft

Create a singleplayer world and open it to LAN (`ESC -> Open to LAN`). Bot will try to connect using port `25565` and hostname `localhost`. These parameters could be configured in `claude_desktop_config.json` on a next step.

MCP Configuration

Make sure that [Claude Desktop](https://claude.ai/download) is installed. Open `File -> Settings -> Developer -> Edit Config`. It should open installation directory. Find file with a name `claude_desktop_config.json` and insert the following code:

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

Double-check that right `--port` and `--host` parameters were used. Make sure to completely reboot the Claude Desktop application (should be closed in OS tray).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 133 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Minecraft MCP Server
  2. <a href="https://github.com/yuniko-software/minecraft-mcp-server/actions">
  3. <img alt="CI" src="https://github.com/yuniko-software/minecraft-mcp-server/actions/workflows/build.yml/badge.svg">
  4. </a>
  5. <a href="https://github.com/yuniko-software">
  6. <img alt="Contribution Welcome" src="https://img.shields.io/badge/Contribution-Welcome-blue">
  7. </a>
  8. <a href="https://github.com/yuniko-software/minecraft-mcp-server/releases/latest">
  9. <img alt="Latest Release" src="https://img.shields.io/github/v/release/yuniko-software/minecraft-mcp-server?label=Latest%20Release">
  10. </a>
  11. <img width="2063" height="757" alt="image" src="https://github.com/user-attachments/assets/3f0f0438-f079-4226-90bd-87b9e1311d19" />
  12. ___
  13. > [!IMPORTANT]
  14. > Currently supports Minecraft version 1.21.11. Newer versions may not work with this MCP server, but we will add support as soon as possible.
  15. https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f
  16. A Minecraft bot powered by large language models and [Mineflayer API](https://github.com/PrismarineJS/mineflayer). This bot uses the [Model Context Protocol](https://github.com/modelcontextprotocol) (MCP) to enable Claude and other supported models to control a Minecraft character.
  17. <a href="https://glama.ai/mcp/servers/@yuniko-software/minecraft-mcp-server">
  18. <img width="380" height="200" src="https://glama.ai/mcp/servers/@yuniko-software/minecraft-mcp-server/badge" alt="mcp-minecraft MCP server" />
  19. </a>
  20. ## Prerequisites
  21. - Git
  22. - Node.js (>= 20.10.0)
  23. - A running Minecraft game (the setup below was tested with Minecraft 1.21.8 Java Edition included in Microsoft Game Pass)
  24. - An MCP-compatible client. Claude Desktop will be used as an example, but other MCP clients are also supported
  25. ## Getting started
  26. This bot is designed to be used with Claude Desktop through the Model Context Protocol (MCP).
  27. ### Run Minecraft
  28. Create a singleplayer world and open it to LAN (`ESC -> Open to LAN`). Bot will try to connect using port `25565` and hostname `localhost`. These parameters could be configured in `claude_desktop_config.json` on a next step.
  29. ### MCP Configuration
  30. Make sure that [Claude Desktop](https://claude.ai/download) is installed. Open `File -> Settings -> Developer -> Edit Config`. It should open installation directory. Find file with a name `claude_desktop_config.json` and insert the following code:
  31. ```json
  32. {
  33. "mcpServers": {
  34. "minecraft": {
  35. "command": "npx",
  36. "args": [
  37. "-y",
  38. "github:yuniko-software/minecraft-mcp-server",
  39. "--host",
  40. "localhost",
  41. "--port",
  42. "25565",
  43. "--username",
  44. "ClaudeBot"
  45. ]
  46. }
  47. }
  48. }
  49. ```
  50. Double-check that right `--port` and `--host` parameters were used. Make sure to completely reboot the Claude Desktop application (should be closed in OS tray).
  51. ## Running
  52. Make sure Minecraft game is running and the world is opened to LAN. Then start Claude Desktop application and the bot should join the game.
  53. **It could take some time for Claude Desktop to boot the MCP server**. The marker that the server has booted successfully:
  54. <img width="885" height="670" alt="image" src="https://github.com/user-attachments/assets/ccbb42f8-6544-462c-8ac1-8af13ddfcddd" />
  55. You can give bot any commands through any active Claude Desktop chat. You can also upload images of buildings and ask bot to build them 😁
  56. Don't forget to mention that bot should do something in Minecraft in your prompt. Because saying this is a trigger to run MCP server. It will ask for your permissions.
  57. Using Claude Sonnet could give you some interesting results. The bot-agent would be really smart 🫡
  58. Example usage: [shared Claude chat](https://claude.ai/share/535d5f69-f102-4cdb-9801-f74ea5709c0b)
  59. ## Available Commands
  60. Once connected to a Minecraft server, Claude can use these commands:
  61. ### Movement
  62. - `get-position` - Get the current position of the bot
  63. - `move-to-position` - Move to specific coordinates
  64. - `look-at` - Make the bot look at specific coordinates
  65. - `jump` - Make the bot jump
  66. - `move-in-direction` - Move in a specific direction for a duration
  67. ### Flight
  68. - `fly-to` - Make the bot fly directly to specific coordinates
  69. ### Inventory
  70. - `list-inventory` - List all items in the bot's inventory
  71. - `find-item` - Find a specific item in inventory
  72. - `equip-item` - Equip a specific item
  73. ### Block Interaction
  74. - `place-block` - Place a block at specified coordinates
  75. - `dig-block` - Dig a block at specified coordinates
  76. - `get-block-info` - Get information about a block
  77. - `find-blocks` - Find one or more nearby blocks of a specific type
  78. ### Furnace
  79. - `smelt-item` - Smelt items using a furnace-like block
  80. ### Entity Interaction
  81. - `find-entity` - Find the nearest entity of a specific type
  82. ### Communication
  83. - `send-chat` - Send a chat message in-game
  84. - `read-chat` - Get recent chat messages from players
  85. ### Game State
  86. - `detect-gamemode` - Detect the gamemode on game
  87. ## Contributing
  88. Feel free to submit pull requests or open issues for improvements. All refactoring commits, functional and test contributions, issues and discussion are greatly appreciated!
  89. To get started with contributing, please see [CONTRIBUTING.md](CONTRIBUTING.md).
  90. ---
  91. ⭐ If you find this project useful, please consider giving it a star on GitHub! ⭐
  92. Your support helps make this project more visible to other people who might benefit from it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.