mcpField
Q
Quady3D MCP

Quady3D MCP

本地服务
quady3d.com媒体与设计01 周前更新
代码仓库访问官网

关于 Quady3D MCP

Quady3D MCP 是本地 MCP 服务，可根据文本或选定图片生成 3D 资产，并将其保存到配置的项目文件夹。它面向使用 Quady3D 模型的用户，支持查询额度报价和恢复已有任务。

主要功能

  1. 01根据文本或图片生成资产
  2. 02列出可用模型与账户信息
  3. 03查询生成所需额度
  4. 04创建并恢复生成任务
  5. 05将资产下载到允许的文件夹

适用场景

  1. 01根据文字描述生成 3D 模型
  2. 02生成前检查模型访问权限和报价
  3. 03提交状态不确定时恢复任务
  4. 04将下载的 GLB 保存到项目文件夹

MCP 相关

向 MCP 客户端提供八种工具，用于查询模型和账户、上传文件、获取报价、创建及恢复任务，以及下载资产。文件访问仅限明确配置的项目根目录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "quady3dai": {
      "command": "npx",
      "args": [
        "-y",
        "@quady3d/mcp"
      ],
      "env": {
        "QUADY3D_API_KEY": "<QUADY3D_API_KEY>",
        "QUADY3D_ALLOWED_ROOTS": "<QUADY3D_ALLOWED_ROOTS>"
      }
    }
  }
}
启动命令npx -y @quady3d/mcp
需要配置的环境变量
QUADY3D_API_KEY密钥Create a limited key at https://quady3d.com/account?section=connections. Generation uses account credits; model downloads require download access. Store the key in the MCP host environment, never in chat.
QUADY3D_ALLOWED_ROOTSJSON array of existing absolute project directories that the server may read and write. Limit access to the project folders you choose.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@quady3d/mcp0.1.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Quady3D

Quady3D MCP 0.1.2

官方设置 · API 文档 · 模型 · 源代码

Quady3D AI 官方本地 MCP 服务。需要 Node.js 22+。根据文本或一张选定的图片创建 3D 资源、恢复原始任务，并将文件保存到允许的项目文件夹中。客户端采用 MIT 许可；云端使用需要 Quady3D 账户、额度和模型下载访问权限。

安装

npm install --global --ignore-scripts @quady3d/[email protected]
quady3d-mcp --version
quady3d-mcp connect

版本命令会输出 0.1.2。在已连接的应用中创建访问密钥，并授予生成和下载权限，同时为每项任务和每日设置较低限额。将密钥粘贴到隐藏的终端提示中。密钥会作为本地私有文件存储在 ~/.config/quady3d/connection.json（POSIX 权限为 600）。此存储方式并非加密的钥匙串存储。命令或聊天中都不会包含密钥。服务环境中的 QUADY3D_API_KEY 优先级更高；QUADY3D_API_KEY_FILE 可指定其他绝对路径的连接文件。connect --replace 会明确替换已保存的密钥。connect --stdin 可从密码管理器的标准输出接收密钥。

此软件包通过官方 @quady3d npm 组织分发。全局 npm 安装需要可写的 npm 前缀；请使用 Node 版本管理器，或在单独的本地目录中运行 npm install --ignore-scripts @quady3d/[email protected] 安装，并将其 node_modules/@quady3d/mcp/dist/cli.mjs 与 command = "node" 配合使用。也可以从 Quady3D 下载获取带版本号的归档文件和校验和。

连接 Codex

运行 command -v quady3d-mcp 查找可执行文件。在 ~/.codex/config.toml 中添加以下部分，并替换两个绝对路径。保留其他无关设置。

[mcp_servers.quady3d]
command = "/absolute/path/to/quady3d-mcp"
args = ["--root", "/absolute/path/to/project"]
tool_timeout_sec = 180
default_tools_approval_mode = "writes"

重启 MCP 连接或启动新的 Codex 会话。请 Agent 检查你的 Quady3D 账户、模型和可写项目目录；此操作不会生成内容，也不会扣除额度。在受管主机上，管理员策略可能要求审批或阻止连接。出现提示时，请在主机中批准所请求的文件操作或生成操作；不要禁用主机的沙盒或审批策略。已在 macOS 上验证 Codex CLI 0.163.0-alpha.11 与独立 MCP 和 Skill 的兼容性。此版本尚未验证 Claude Code 和 Claude Desktop。

只有明确配置的现有项目文件夹才可读写。添加多个 --root 可指定多个文件夹。QUADY3D_ALLOWED_ROOTS 是绝对路径 JSON 数组的替代配置方式。请将私有恢复数据保存在这些根目录之外。API 默认地址为 https://quady3d.com/api/v1；只有在连接其他可信服务时才设置 QUADY3D_API_URL。

首个任务

安装配套的 Skill，然后提出以下请求：

使用 $quady3d 创建一个木箱。检查我的下载权限、可用模型和报价。请让我授权额度上限。在此项目中保存一个新的 GLB 文件，并在中断时恢复原始任务。

这 8 个工具分别是 quady3d_list_models、quady3d_get_account、quady3d_upload_file、quady3d_quote、quady3d_create_job、quady3d_get_job、quady3d_list_jobs 和 quady3d_download_asset。报价不会生成内容；创建任务会预留额度。余额、密钥限额和下载权限彼此独立。图像输入仅支持一张不超过 8 MiB 的 PNG/JPEG/WebP 图片。上传文件会在 30 分钟后过期，报价会在 5 分钟后过期。

恢复和文件

在提交状态不确定时，保留原始操作、引述、正文和额度限制。查询现有任务 ID，而不是创建替代任务。再次等待或下载不会触发生成。下载会保留现有文件，并限制在允许的根目录内。目标文件系统必须支持硬链接。在 3D 工具中检查交付的几何体、纹理和比例。

私有恢复状态默认存储在平台的用户状态目录下的 quady3d/mcp 中。QUADY3D_STATE_DIR 可指定项目根目录之外的其他绝对目录。其中包含提示词和任务标识符，不包含访问密钥。在使用过程中，已确认的终止和交付记录会在七天后清理；尚未解决的提交会保留。

更新或移除

安装明确指定的较新软件包版本，然后重启连接。若要断开连接，只移除 Quady3D MCP 部分，并在 Connected apps 中撤销其密钥。npm uninstall --global @quady3d/mcp 会移除全局软件包。删除已保存的连接文件会断开使用该文件的本地使用者；在所有原始任务解决前，请保留恢复记录。这些操作都不会取消已接受的云端任务，也不会删除已保存的模型文件。

请参阅设置和故障排除、校验和与源代码，以及随附的 LICENSE 和第三方声明。

对于本地归档服务器，请将 QUADY3D_PACKAGE_ORIGIN 设置为其环回源，并在上方的归档 URL 中使用该源。软件包源和 API 源相互独立：只有在确定要调用的可信服务时，才设置 QUADY3D_API_URL。

下载内容会流式写入私有临时文件，并且只有完整文件才会发布，且不会覆盖现有输出。传输中断后，请重试同一资产 ID。目前未实现字节范围续传。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。