dend/brick-mcp-app

Разработчик MCP App

Приложение Three.js MCP для проектирования 3D кирпичных конструкций внутри хостов с поддержкой MCP, таких как Claude Desktop и Visual Studio Code. Постройте интерактивно или позвольте ИИ создавать структуры для вас с помощью естественного языка.

Быстрый старт • Подключение • Инструменты • расширяемость

Brick Builder работает в Клоде, создавая структуру на естественном языке

Быстрый старт

Сервер начинается с http://localhost:3001/mcp.

Предпосылки

Node.js 20+ npm 10+

Команды

| Командование | Описание [скрыто] [скрыто] [скрыто] [скрыто] [скрыто] [[Т1]] Установите зависимости npm run build | Построить клиент (Vite) + сервер (esbuild) | | npm run serve | Стартовый сервер в режиме dev (tsx, автозагрузка) | | npm run dev | Клиент часов + обслуживает одновременно | [5][править править код][править править код]

Архитектура

Сервер является единственным источником истины для всех состояний сцены. И ИИ (LLM), и интерактивный пользовательский интерфейс мутируют исключительно через инструменты MCP. Сервер проверяет каждую операцию — обнаружение столкновений, проверку границ, проверку поддержки — и возвращает авторитетные результаты.

Ключевые дизайнерские решения

Brick Builder running in Claude, building a structure through natural language

Quick Start

git clone https://github.com//brick-mcp-app.git
cd brick-mcp-app
npm install
npm run build
npm run serve

The server starts at http://localhost:3001/mcp.

Prerequisites

• Node.js 20+
• npm 10+

Commands

Architecture

The server is the single source of truth for all scene state. Both the AI (LLM) and the interactive UI mutate state exclusively through MCP tools. The server validates every operation — collision detection, bounds checking, support verification — and returns authoritative results.

Key Design Decisions

• Shared module-level state: The host creates separate MCP sessions for the LLM and the app iframe. Scene state lives at module level so both sessions read/write the same scene.
• Polling for cross-session sync: The UI polls brick_get_scene every second to pick up LLM-initiated changes. User-initiated changes (via callServerTool) are reflected instantly.
• Single-brick placement: The LLM places one brick per brick_place call and receives the placed brick’s footprint in the response, enabling precise positioning of subsequent bricks.

Connecting to Hosts

[!TIP] You can use Cloudflare Tunnels to expose your locally-hosted server to the internet. This lets you connect from claude.ai or any remote MCP host without port forwarding or VPNs: