cobble-mcp

<pre align="center"> ┌─────────────────────────────────────────┐ │ <You> build a cabin next to me │ │ <Claude> On it — surveying the patch │ │ <Claude> Done — door south. What's next?│ │ <You> kill that creeper │ │ <Claude> Target locked. Coming. │ └─────────────────────────────────────────┘ </pre>

<h1 align="center">COBBLE</h1> <p align="center"><strong>Minecraft, for your AI.</strong><br/>Not RCON. Not a mod helper. A teammate in the world.</p>

<p align="center"> <a href="https://github.com/brian-mwirigi/cobble-mcp"><img alt="GitHub" src="https://img.shields.io/badge/github-brian--mwirigi%2Fcobble--mcp-55C57A?style=flat-square" /></a> <img alt="npm" src="https://img.shields.io/badge/npx-cobble--mcp-111?style=flat-square" /> <img alt="hooks" src="https://img.shields.io/badge/hooks-peak-ff2d55?style=flat-square" /> <img alt="mineflayer" src="https://img.shields.io/badge/bot-mineflayer-3E8E41?style=flat-square" /> </p>

npx -y cobble-mcp

Then in Cursor: “play with me” · “build a house next to me” · type in Minecraft chat and it answers.

<p align="center"> <a href="CONTRIBUTING.md"><img alt="contributions welcome" src="https://img.shields.io/badge/contributions-welcome-55C57A?style=flat-square" /></a> <a href="ROADMAP.md"><img alt="roadmap" src="https://img.shields.io/badge/roadmap-open-111?style=flat-square" /></a> <a href="examples/designs"><img alt="design packs" src="https://img.shields.io/badge/design%20packs-PRs%20open-ff2d55?style=flat-square" /></a> </p>

---

Film this (go viral)

Clip (30–60s)	How
Cabin from nothing	play with me → build me a witch hut → watch mc_design rise
Chat teammate	Type in Minecraft: come · what should we build · kill that
Fix my grief	Break a wall → fix it → mc_repair
Style flex	Same prompt twice → two different designs (agent mind, not a stamp)

Post with #cobble + the repo link. Clips > screenshots.

---

Why this hits

Clips of Claude actually placing blocks spread. Admin panels don't.

COBBLE drops a Mineflayer bot into your server. Same chunk as you. Chat, path, dig, build, swing at creepers — directed co-op, not a silent autofill.

You say (Cursor or in-game)	What happens
play with me	mc_play loop — agent brain stays live
build a cabin here	mc_design — YOU invent palette + ASCII floors (never the same box)
come / kill this creeper	Instant reflexes in chat (no waiting on Cursor)
what should we do?	Agent answers with pulse + memory + this chat
fix it / clear that	mc_repair / mc_clear on the last site

Cookie-cutter mc_build_house is demoted — viral builds come from the agent's mind via mc_design / mc_sculpt.

---

60-second setup

1. Java world — creative + online-mode=false for easy demos
2. Wire Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "cobble": {
      "command": "npx",
      "args": ["-y", "cobble-mcp"],
      "env": {
        "MC_HOST": "localhost",
        "MC_PORT": "25565",
        "MC_USERNAME": "Claude",
        "MC_AUTH": "offline",
        "MC_FAST": "1",
        "MC_BRAIN": "agent"
      }
    }
  }
}

Local clone? Point command/args at node + dist/server.js instead.

3. Reload MCP → in Cursor: play with me → talk in Minecraft.

---

How the brain works

You (the Cursor agent) are the brain. Not a side API that forgot the cabin you just built.

mc_connect → mc_come → loop: mc_play → think → mc_chat / build → mc_play

• come / kill / stop — instant in-process reflexes
• Plans, opinions, builds — agent via mc_play
• Builds run in the background — tool returns now; poll mc_build_status

---

Peak tools

<details> <summary><strong>Live co-op</strong></summary>

mc_play · mc_pulse · mc_hang · mc_chat · mc_read_chat · mc_wait_chat · mc_note · mc_autotalk </details>

<details> <summary><strong>Move</strong></summary>

mc_come · mc_goto · mc_stop · mc_status · mc_connect · mc_disconnect </details>

<details> <summary><strong>Build smart</strong></summary>

mc_design · mc_sculpt · mc_build · mc_build_wall · mc_build_house (lazy) · mc_survey_site · mc_repair · mc_clear · mc_build_status · mc_stop_build · mc_scan · mc_inventory </details>

Creative + MC_FAST=1 → timed /setblock (no pathfind freeze mid-farm).

---

Env

Var	Default
MC_HOST	localhost	Server host
MC_PORT	25565	Server port
MC_USERNAME	Claude	Bot name
MC_AUTH	offline	or microsoft
MC_FAST	1	Creative setblock path
MC_BRAIN	agent	Cursor is the brain

---

Dev

git clone https://github.com/brian-mwirigi/cobble-mcp
cd cobble-mcp
npm i && npm run build && npm run smoke
npm start   # MCP stdio

---

Contribute

Easiest win: add an ASCII design pack under examples/designs/ — no TypeScript.

Code / tools: see CONTRIBUTING.md · grab something from ROADMAP.md.

Open a PR that answers: what clip does this unlock?

---

<p align="center"> <strong>COBBLE</strong> — same world. Your call. Its hands.<br/> _{MIT · Mineflayer · Model Context Protocol} </p>