Sharing is Caring: Open-Sourcing Our Minecraft MCP Server for ACDC 2026

Posted on by

Why We’re Sharing

At ACDC 2026, we believe that innovation happens faster when we collaborate. That’s why we’re excited to share our Minecraft Builder MCP Server with all participating teams. This isn’t just about fulfilling a badge requirement – it’s about creating a foundation that all teams can build upon.

Whether you’re working on voice-controlled building, IoT-triggered construction, AI-driven city planning, or any other creative Minecraft integration, our server and API can help you get there faster.

What We’re Sharing

Complete MCP Server Implementation

We’ve open-sourced our entire Model Context Protocol (MCP) server that connects AI coding assistants to Minecraft. This includes:

  • Full Source Code: TypeScript implementation with comprehensive error handling
  • Docker Support: Ready-to-deploy containerized solution
  • Example Scripts: Working examples for building houses, towers, and castles
  • Complete Documentation: Setup guides, API reference, and troubleshooting

GitHub Repository: https://github.com/miraculesx/ACDC404

Live REST API Access

Don’t want to run the server yourself? We’re hosting a public API endpoint that ALL teams can use:

http://ptacdc2026.norwayeast.cloudapp.azure.com:25611

This means you can start building in Minecraft right now without any setup. Just call our API with a simple HTTP request and you’ll be placing blocks in seconds.

Real-World Use Cases

Here’s how we imagine teams could use this:

Voice-Controlled Building System
If you’re building a voice assistant that responds to spoken commands, you can integrate our API to instantly build structures based on what users say. Imagine saying “build a castle at spawn” and watching it materialize in Minecraft within seconds.

IoT-Triggered Construction
Have sensors like our micro:bit that trigger building events? Connect them to our API through Azure Functions. When motion is detected, automatically build a tower. When a door opens, place a block. The possibilities are endless.

AI-Driven City Planner
Want an AI agent to design and build an entire city? Use our API to let GPT or other AI models plan layouts and then execute the construction automatically. Build entire neighborhoods with a single command.

Power Platform Integration
Building a low-code solution with Power Automate? Add an HTTP action that calls our API. Now your flows can build Minecraft structures based on form submissions, emails, or any other trigger.

Complete API Reference

All endpoints are available at: http://ptacdc2026.norwayeast.cloudapp.azure.com:25611

Building Structures

POST /api/build
Send a JSON body with structure type (house, tower, castle, or platform) and x, y, z coordinates. Optionally specify material.

Available Structures:

  • house: 7x6x7 block house with door and windows
  • tower: 5x20x5 tall tower
  • castle: 20x15x20 castle with walls and towers
  • platform: 10x1x10 flat platform

Block Operations

POST /api/block/place – Place a single block at specific coordinates with chosen block type
POST /api/block/break – Break a block at specific coordinates

Terrain Management

POST /api/terrain/clear – Clear an area between two coordinate points
POST /api/terrain/fill – Fill area with specific block type
POST /api/terrain/flatten – Flatten terrain in radius around center point

Bot Control

GET /api/bot/position – Get current bot position
POST /api/bot/goto – Navigate bot to specific location
POST /api/bot/look – Make bot look at specific position
POST /api/chat – Send chat message to Minecraft server

Technical Architecture

Our solution uses a multi-layer architecture:

AI Coding Assistant (GitHub Copilot, Claude) talks to MCP Server (Node.js/TypeScript) which talks to Minecraft Plugin (Java – Bukkit/Spigot) which controls a Mineflayer Bot in Minecraft Server (Java Edition 1.21).

The MCP server acts as a translation layer between high-level AI instructions like “build a castle” and low-level Minecraft commands that place thousands of individual blocks in specific positions.

Why Model Context Protocol (MCP)?

MCP is a protocol for connecting AI coding assistants to external tools and data sources. By implementing MCP, our server can work with multiple AI assistants, provide structured typed interfaces for building operations, enable natural language commands, and maintain context across multiple building operations.

Fair Use and Rate Limiting

To ensure the API remains available for all teams:

  • Request Limit: approximately 5 requests per second per team
  • Best Practice: Add 200-500ms delays between sequential requests
  • Bulk Operations: Prefer batching when building multiple structures
  • Contact Us: Need higher limits? Let’s talk!

Getting Started in 5 Minutes

Option 1: Direct API Usage (No Installation)

Test connection by calling the bot position endpoint. Then build your first structure by sending a POST request with structure type and coordinates. That’s it – you just built something in Minecraft!

Option 2: Clone and Run Locally

Clone our GitHub repository, install dependencies with npm, build with npm run build, and start with npm start. Then configure your AI assistant to use the MCP server by adding it to your MCP configuration.

Repository Contents

When you clone the repository, you get the full TypeScript source code, example scripts for building houses, castles and towers, Docker and docker-compose configurations, complete documentation, and all necessary dependencies.

Our Story: From Webcam to Minecraft

This MCP server is part of our larger ACDC 2026 solution that combines a physical Lego plate with color markers, MacBook webcam running OpenCV, micro:bit v1 with PIR sensor, Azure Functions for processing, Blob Storage for snapshots, and this MCP Server to translate everything into Minecraft builds.

The MCP server connects the digital world (Azure, sensors, AI) to the Minecraft world, creating a tangible representation of events.

Badges This Fulfills

Sharing is Caring: “Code, dataset or Api is made available for other teams”

  • Public GitHub repository with full source code
  • Live REST API accessible to all teams
  • Complete documentation and examples
  • Docker support for easy deployment

We’re also looking for: “Sensible contribution (pull request, integration) on a competing teams solution” – We’d love to integrate with your solution!

Want to Contribute?

We’re actively looking for teams to collaborate with! If you have an interesting use case or want to integrate this into your solution, we’d love to help with integration support, custom features, performance optimization, or cross-team collaboration.

Contact and Support

During ACDC 2026 Hackathon find us at Soria Moria Hotel, Holmenkollen – look for “404 No Diamonds Found” table sign.

Example Scenarios We’d Love to See

  • Voice-Activated City Builder: “Alexa, build a medieval city”
  • IoT Smart Home: Door sensor triggers castle wall construction
  • Social Media Integration: Twitter mentions = building placement
  • AI Urban Planner: Let GPT-4 design entire cities
  • Gesture Control: Use Kinect/camera to “paint” structures in 3D space
  • Music Visualizer: Build structures that react to music beats
  • Game-ification: Points system that builds structures as rewards
  • Educational Tool: Teach coding by building Minecraft structures
  • Remote Collaboration: Multiple teams building in same world
  • Time-Based Events: Scheduled constructions like New Year’s fireworks tower

Performance Characteristics

Based on our testing:

  • Single Block Placement: approximately 50ms including network latency
  • Small Structure (House): 2-3 seconds (49 blocks)
  • Medium Structure (Tower): 5-7 seconds (500 blocks)
  • Large Structure (Castle): 30-40 seconds (2000+ blocks)
  • API Response Time: less than 100ms for most operations
  • Concurrent Requests: Supports up to 10 simultaneous builders

License

This code is open source for ACDC 2026 hackathon participants. Feel free to use it in your solutions, modify and extend it, share it with other teams, and build commercial projects on top of it after the hackathon. No attribution required, but we’d love to know what you build with it!

Acknowledgments

This project uses amazing open-source libraries: Mineflayer for Minecraft bot framework, MCP SDK for Model Context Protocol implementation, Express for web framework, and TypeScript for type-safe JavaScript.

Special thanks to the ACDC 2026 organizers for creating an environment where sharing and collaboration are celebrated!

Final Thoughts

We believe that hackathons are not just about competition – they’re about pushing the boundaries of what’s possible together. By sharing our MCP server, we hope to save time for teams so they can focus on unique ideas instead of infrastructure, enable creativity by making Minecraft integration accessible to all teams, foster collaboration to build connections between teams and solutions, and raise the bar so when everyone has better tools, everyone builds better solutions.

We can’t wait to see what you build with it!

Let’s build something amazing together!

Team 404 No Diamonds Found
Arctic Cloud Developer Challenge 2026

Quick Reference

Essential Endpoints:

  • POST /api/build with JSON body: structure (house, tower, castle), x, y, z coordinates
  • POST /api/block/place with JSON body: x, y, z coordinates and block type
  • GET /api/bot/position to get current position
  • POST /api/chat with JSON body: message text
  • Rate Limits:
  • 5 requests per second per team
  • 200ms minimum delay between requests

Updated: January 23, 2026, 00:30 CET