MCP Server

概述

1. 可以采用符合MCP规范的方式接入柜柜客户端提供的MCP Server

• 路由：http://127.0.0.1:****

• 版本：5.0.0.0及以上

2. 大部分MCP资源/工具需要登录后使用

错误处理

错误码说明

错误响应示例

{
    "status": "error",
    "code": -32003,
    "message": "用户未登录",
    "data": "额外的错误信息（可选）"
}

成功响应示例

{
    "status": "success",
    "content": "响应内容",
    "mimeType": "text/plain"
}

使用建议

推荐工作流程

1. 登录前：可使用 guigui://info/guigui_version 和 guigui://info/login_status 检查应用状态

2. 获取信息：使用 guigui://info/current_page 确认当前页面，使用 guigui://info/parametric_models 获取可用的参数化模型列表

3. 创建设计：

• 使用 quick_open_project 打开或创建订单

• 使用 design_create_model 创建普通模型

4. 编辑设计：

• 使用 guigui://info/model_structure 获取模型结构，了解组件编号

• 使用 design_edit_model 编辑模型结构

5. 保存设计：使用 design_use_design_tool 工具，选择 “保存” 功能

常见问题

• 如何获取参数化模型列表？
  使用 guigui://info/parametric_models 资源，返回按类型分组的模型列表

• 如何编辑已创建的模型？
  可使用 design_edit_model 编辑模型结构

• 哪些操作需要登录？
  除了 guigui://info/guigui_version 和 guigui://info/login_status 外，其他所有资源和工具都需要登录

资源(resources)

查询资源列表

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "resources/list"
}

读取资源

参数说明

部分资源

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "resources/read",
    "params": {
        "uri": "guigui://info/guigui_version"
    }
}

资源说明

• 可通过查询资源列表获取最新的资源说明

• 文档中列出的以下内容仅供参考，实际使用时应通过相应接口获取最新信息

推荐做法：每次使用前调用 resources/list 获取最新的资源说明

guigui://info/guigui_version

返回应用版本字符串，例如："5.0.0.0"

guigui://info/login_status

返回用户登录状态，返回值为 "已登录" 或 "未登录"

guigui://info/current_page

返回当前页面名称，例如："设计页面"

guigui://info/model_structure

返回当前模型的模型结构信息（JSON格式），包含所有组件的层级结构、编号、类型、尺寸等信息

guigui://info/parametric_models

返回参数化模型列表（JSON格式），按类型分组，包含模型编号、名称、标签等信息。返回格式示例：

{
    "衣柜": [
        {
            "id": "74236",
            "name": "1-5门缩放衣柜",
            "tag": [
                "示例标签"
            ]
        }
    ],
    "书柜": [...],
    "橱柜": [...]
}

工具(tools)

查询工具列表

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/list"
}

调用工具

部分工具

工具说明

• 可通过查询工具列表获取最新的工具说明

• 文档中列出的以下内容仅供参考，实际使用时应通过相应接口获取最新信息

推荐做法：每次使用前调用 tools/list 获取最新的工具定义和可选参数列表

quick_open_project

简要描述

• 快速打开订单/房间, 如果未找到对应订单/房间, 则创建新订单/房间

• 需要登录

参数说明

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "quick_open_project",
        "arguments": {
            "designInfo": {
                "buyerAddress": "示例地址"
            }
        }
    }
}

design_create_model

简要描述

• 在设计页面创建模型

• 需要登录

• 可通过 guigui://info/parametric_models 资源获取参数化模型列表

参数说明

参数化模型列表

参数化模型工艺参数

• 转角柜: 左侧深, 右侧深

• 单元柜: 板件颜色, 柜门颜色, 抽面颜色

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "design_create_model",
        "arguments": {
            "models": [
                {
                    "id": "74236",
                    "name": "1-5门缩放衣柜",
                    "cube": {
                        "x": 0,
                        "y": 0,
                        "z": 0,
                        "width": 1000,
                        "height": 2400,
                        "depth": 600
                    },
                    "params": {
                        "板件颜色": "白色",
                        "柜门颜色": "灰色"
                    }
                }
            ]
        }
    }
}

design_preview_scheme

简要描述

• 在设计页面预览模型方案

• 需要登录

参数说明

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "design_preview_scheme",
        "arguments": {
            "schemes": [
                {
                    "id": "scheme1",
                    "title": "方案1",
                    "type": "参数化模型",
                    "models": [
                        {
                            "id": "74236",
                            "name": "1-5门缩放衣柜",
                            "cube": {
                                "x": 0,
                                "y": 0,
                                "z": 0,
                                "width": 1000,
                                "height": 2400,
                                "depth": 600
                            }
                        }
                    ]
                }
            ]
        }
    }
}

design_edit_model

简要描述

• 在设计页面编辑模型

• 需要登录

参数说明

操作参数说明

• 清空房间：不需要传入参数

• 应用三方数据：format, content

• 可具体对接

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "design_edit_model",
        "arguments": {
            "operate": "清空房间"
        }
    }
}

design_use_design_tool

简要描述

• 在设计页面操作设计工具

• 需要登录

参数说明

工具列表

• 保存、存入模型库、保存历史、转发给好友、同步到知户型、发送到酷家乐

• 房间锁定、导入酷家乐文件、草图识别、导入CAD图纸

• 所有孔槽、局部孔槽、更新孔槽

• 显示标尺、爆炸图、结构图、边缘显示框线、显示板件编号、隐藏颜色显示、封边显示

• 动画、柜门动画、抽屉动画、柜门、抽屉、未选中、选中

• 标注、板件备注

• 撤销、重做、恢复初始状态、复制、粘贴、镜像、删除、均分

• 审单、补件、切角

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "design_use_design_tool",
        "arguments": {
            "toolName": "保存"
        }
    }
}

design_get_room_info

简要描述

• 在设计页面获取房间信息

• 需要登录

参数说明

信息类型列表

• 千里眼链接

请求示例

{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
        "name": "design_get_room_info",
        "arguments": {
            "info": "千里眼链接"
        }
    }
}