brick -app

Brick Builder MCP App is a 3D brick design tool that runs inside MCP-enabled hosts (such as Claude Desktop or Visual Studio Code). The server acts as the single source of truth for the scene state and exposes a set of MCP Tools that let you read, place, move, and manage bricks in a collaborative, LLM-assisted environment. You can connect to a host, open the 3D viewer, and issue commands like brick_get_available to list brick types, brick_place to add bricks, brick_get_scene to inspect the current construction, and brick_render_scene to display the 3D viewport. The app supports AI-assisted building via natural language in addition to interactive placement, with strict validation (collision detection, bounds checking, and support verification) to keep the scene consistent across sessions.

Prerequisites:

• Node.js 20+ and npm 10+ installed on your machine
• Access to a host where the MCP server will run

Install and run locally:

1. Clone the repo and navigate to the project directory git clone https://github.com/dend/brick-mcp-app.git cd brick-mcp-app
2. Install dependencies npm install
3. Build the client and server (as defined by the project scripts) npm run build
4. Start the MCP server npm run serve

If you need to run in a different environment (e.g., Docker or Python), adapt the commands to your deployment method while ensuring the server exposes the /mcp endpoint (e.g., http://localhost:3001/mcp) for MCP hosts to connect.

Tips and common issues:

• If you expose the server to the internet, consider using a tunnel (like Cloudflare Tunnels) and point your MCP host to the generated URL with /mcp appended.
• Claude Desktop requires adding a custom connector for HTTP-based MCP servers; Visual Studio Code has native HTTP MCP support via .vscode/mcp.json.
• The MCP Tools are the primary API surface for building and querying the scene; use brick_render_scene before placing bricks to ensure the 3D viewer is ready.
• Brick placement is validated; after brick_place, the response includes the footprint for precise subsequent placements.
• For extensibility, new brick types can be added by defining bricks/definitions and ensuring the server validates and renders them in the UI.