Skip to content

Releases: cuspymd/mcp-server-mod

MCP Server Mod v1.0.0 for Minecraft 1.21.4

13 Aug 16:34

Choose a tag to compare

MCP Server Mod v1.0.0 for Minecraft 1.21.4

Overview

First stable release of the MCP Server Mod - a Fabric mod that implements a Model Context Protocol (MCP) server, enabling AI assistants like Claude to interact with Minecraft through structured commands.

Features

  • MCP Protocol Support: Full HTTP server implementation on port 8080
  • Three Core Tools:
    • execute_commands - Execute Minecraft commands with safety validation
    • get_player_info - Get comprehensive player information (position, health, inventory)
    • get_blocks_in_area - Scan and retrieve blocks in specified areas
  • Safety System: Comprehensive command validation and size limits
  • Block Compression: Optimized block change representation using connected regions
  • Async Execution: Non-blocking command execution

Requirements

  • Minecraft 1.21.4
  • Fabric Loader 0.16.14+
  • Fabric API 0.119.3+1.21.4
  • Java 21+

Installation

  1. Install Fabric Loader for Minecraft 1.21.4
  2. Download and install Fabric API
  3. Place the mod JAR in your mods folder
  4. Launch Minecraft - MCP server starts automatically on localhost:8080

Usage

Connect your AI assistant to http://localhost:8080/mcp and use the available tools to interact with Minecraft safely and efficiently.

Technical Details

  • Client-side mod with HTTP MCP server
  • Comprehensive safety validation system
  • Block change compression and optimization
  • Chat message capture during command execution
  • Configurable via config/mcp-client.json

🤖 Generated with Claude Code