内容
# 家具设计工具适用于 Cursor
适用于 **Cursor IDE** 的专业家具设计插件。使用与 Claude Code 插件相同的 MCP 服务器，适配 Cursor 的规则和配置格式。
## 要求
- [Cursor IDE](https://cursor.com/)，并启用 MCP 支持
- Python 3.12+，安装 `uv`（使用 `pip install uv`）
- `furniture-designer-mcp` 包（通过 `uvx` 自动安装）
## 安装
### 选项 1：自动脚本
```bash
# 从 Cursor 项目根目录：
curl -fsSL https://raw.githubusercontent.com/LuisEnVilla/furniture-designer-cursor/main/install.sh | bash
```
### 选项 2：手动安装
1. **配置 MCP 服务器** — 将 `.cursor/mcp.json` 复制到项目根目录：
```bash
mkdir -p .cursor
cp .cursor/mcp.json <你的项目>/.cursor/mcp.json
```
或手动添加到现有的 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"furniture-designer": {
"command": "uvx",
"args": ["furniture-designer-mcp"]
}
}
}
```
2. **安装规则** — 将 `.mdc` 规则文件复制到项目规则目录：
```bash
mkdir -p .cursor/rules
cp .cursor/rules/furniture-designer.mdc <你的项目>/.cursor/rules/
```
3. **重启 Cursor** 以检测新的 MCP 服务器和规则。
### 选项 3：全局配置（所有项目）
如果您希望在所有 Cursor 项目中都可以使用 MCP 服务器，请在 **Cursor 设置 > MCP** 中进行配置：
1. 打开 Cursor 设置（`Cmd+,`）
2. 搜索 "MCP"
3. 添加新的服务器：
- **名称：** `furniture-designer`
- **命令：** `uvx`
- **参数：** `furniture-designer-mcp`
将规则文件复制到全局规则目录：
```bash
cp .cursor/rules/furniture-designer.mdc ~/.cursor/rules/furniture-designer.mdc
```
## 使用
安装完成后，打开 Cursor 聊天窗口（Composer）并输入：
```
设计一个 180x240x60 的衣柜，采用 18mm 厚的三聚氰胺板，左侧有抽屉，右侧有架子
```
规则会自动激活，当检测到家具设计相关的关键词时。代理将遵循 4 个阶段的协议：
1. **发现** — 确认类型、尺寸、材料、布局
2. **生成** — 创建设计、验证、优化切割、生成 HTML 报告
3. **迭代** — 根据用户反馈修改设计
4. **导出** — 物料清单、装配说明、FreeCAD 模型
交互式报告在 `http://localhost:8432/{design_id}` 中提供，包含：
- 3D 查看器（Three.js），支持轨道缩放平移
- 点击面板查看尺寸
- 板材切割布局 SVG
- 版本比较滑块
- WebSocket 实现的实时加载
## FreeCAD（可选）
要导出 3D 模型、爆炸视图和技术图纸：
1. 安装 FreeCAD 0.21+
2. 在 FreeCAD 中安装 `freecad-mcp` 插件
3. 启动 FreeCAD 中的 RPC 服务器（工作台 "MCP 插件" > "启动 RPC 服务器"）
4. 将以下配置添加到 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"furniture-designer": {
"command": "uvx",
"args": ["furniture-designer-mcp"]
},
"freecad": {
"command": "uvx",
"args": ["freecad-mcp", "--only-text-feedback"]
}
}
}
```
## 与 Claude Code 插件的区别
| 方面 | Claude Code 插件 | Cursor 插件 |
|---------|-------------------|---------------|
| 格式 | `.claude-plugin/` + `skills/` | `.cursor/rules/` + `.cursor/mcp.json` |
| 激活 | 显式技能 `/furniture` | 聊天中关键词自动激活 |
| 安装 | `claude plugin add <url>` | 复制文件到 `.cursor/` |
| MCP 服务器 | 相同（`furniture-designer-mcp` via `uvx`） | 相同 |
| 协议 | 相同（4 阶段，10 条反幻觉规则） | 相同 |
## 可用的 MCP 工具（23）
MCP 服务器提供了 23 种工具，分类如下：
- **设计（6）：** `design_furniture`, `get_standards`, `get_material_specs`, `get_structural_rules`, `get_hardware_catalog`, `get_assembly_specs`
- **验证（4）：** `validate_structure`, `generate_bom`, `optimize_cuts`, `get_assembly_steps`
- **多设计（6）：** `create_design`, `list_designs`, `get_design_context`, `get_section_map`, `start_design_server`, `update_design_report`
- **FreeCAD（6）：** `build_3d_model`, `build_exploded_view`, `build_cut_diagram`, `build_techdraw`, `build_import_script`, `parse_freecad_import`
- **开发（1）：** `reload_engine`
## 相关仓库
- [furniture-designer-mcp](https://github.com/LuisEnVilla/furniture-designer-mcp) — MCP 服务器（设计引擎）
- [furniture-designer-plugin](https://github.com/LuisEnVilla/furniture-designer-plugin) — Claude Code 插件
## 许可证
MIT
