Brick MCP

砖mcp

一 主控程序 服务器，允许AI助手创建、检查和编辑存储在BrickLink Studio中的LEGO模型(.io)和LDraw(.ldr)文件。让你的AI助手打开一个文件，移动零件，改变颜色，添加新的砖块，然后保存回直接在BrickLink Studio中打开的文件。

特性

• 打开并保存 BrickLink工作室 .io 文件和普通LDraw .ldr / .mpd 文件
• 列出零件，检查物料清单，查看建筑说明步骤
• 按会话ID添加、删除、移动、旋转和重新着色单个零件
• 搜索内置零件数据库并查找LDraw颜色代码
• 使用从头开始创建新模型 new_model()

需求

• Python≥3.14
• 拒绝 （推荐--自动处理所有依赖关系）

如果没有Nix，请手动安装Python依赖项：

pip install "fastmcp>=3.1.0" "pyzipper>=0.3.6"

MCP客户端配置

VS Code

存储库提供了一个即用型 .vscode/mcp.json 使用Nix：

{
  "servers": {
    "bricks": {
      "type": "stdio",
      "command": "nix",
      "args": ["run", "/path/to/brick-mcp"]
    }
  }
}

替换 /path/to/brick-mcp 使用本地克隆的路径，或使用 github:datakurre/brick-mcp 直接从GitHub运行，无需克隆。

克劳德桌面(claude_desktop_config.json)

{
  "mcpServers": {
    "bricks": {
      "command": "nix",
      "args": ["run", "github:datakurre/brick-mcp"]
    }
  }
}

没有Nix（本地Python）

{
  "mcpServers": {
    "bricks": {
      "command": "python",
      "args": ["/path/to/brick-mcp/main.py"]
    }
  }
}

典型工作流程

1. open_model("path/to/model.io")   — load a file
2. list_parts()                      — see what's inside
3. change_color("abc123", 4)         — change a part to Red
4. add_part("3001.dat", 4, x=0, y=-24, z=0)  — place a new 2×4 brick
5. save_model()                      — write back to the original file

工具参考

文件操作

检查

编辑

零件和颜色数据库

坐标系

LDraw用途 LDU （LDraw单位）。关键测量：

这 Y轴反转: y=0 是构建板， y=-24 X和Z是水平面。

常用LDraw颜色代码

使用 list_colors() 查看完整列表。

通用零件号

使用 search_parts("brick 2x4") 查找您不知道的零件号。