Skip to content

Repository files navigation

Minecraft MCP Server (Cloudflare Worker)

CI

Easily deploy a remote Model Context Protocol (MCP) server for Minecraft Java server status queries, running on Cloudflare Workers—no authentication required.

🚀 Quick Deploy

Deploy to Workers

This will deploy your MCP server to a URL like:

https://minecraft-mcp.<your-account>.workers.dev/mcp
https://minecraft-mcp.<your-account>.workers.dev/sse

🛠️ Local Development

npm install
npm run dev

🧩 Add Your Own Tools

Define new tools in src/worker.ts using this.server.tool(...) inside the MinecraftMCP class.

🤖 Connect to MCP Clients

  • Cloudflare AI Playground:
    1. Go to https://playground.ai.cloudflare.com/
    2. Enter your /mcp endpoint URL.
  • Any MCP Client (via mcp-remote):
    {
      "mcpServers": {
        "minecraft-mcp": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://minecraft-mcp.<your-account>.workers.dev/mcp"
          ]
        }
      }
    }

📦 Endpoints

  • /mcp — Main MCP JSON-RPC endpoint
  • /sse — Server-Sent Events (SSE) endpoint for streaming

📄 License

MIT

About

Minecraft Server Status MCP server that you can host as a Cloudflare Worker

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages