mcpField
P
PicToSTL

PicToSTL

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

关于 PicToSTL

PicToSTL 是本地 stdio MCP 服务，将图像发送至 pictostl.com 生成 3D 模型，并在本机保存 GLB 或 STL 文件。它适用于可视化和 3D 打印实验，不提供工程图纸。

主要功能

  1. 01上传本地图像或 HTTPS URL
  2. 02启动并查询异步生成任务
  3. 03查看近期生成记录和账户额度
  4. 04保存 GLB 或本地转换的 STL

适用场景

  1. 01根据图像生成 3D 网格
  2. 02查询模型生成任务状态
  3. 03保存模型用于可视化或打印实验

MCP 相关

MCP 客户端通过 stdio 启动本地服务。服务提供七种工具，用于上传图像、管理生成任务、查询账户信息和下载模型文件；生成过程通过 pictostl.com API 执行。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "qduoduo-hwh-pictostl": {
      "command": "npx",
      "args": [
        "-y",
        "pictostl-mcp"
      ],
      "env": {
        "PICTOSTL_API_KEY": "<PICTOSTL_API_KEY>",
        "PICTOSTL_API_BASE": "<PICTOSTL_API_BASE>"
      }
    }
  }
}
启动命令npx -y pictostl-mcp
需要配置的环境变量
PICTOSTL_API_KEY密钥PicToSTL API key. Create one at https://pictostl.com/api-keys
PICTOSTL_API_BASEOptional override for the PicToSTL API base URL

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

安装包
npmpictostl-mcp0.1.0

工具

7

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

pictostl-mcp

面向 pictostl.com 的本地 stdio MCP 服务。生成任务在 pictostl.com 上运行——此软件包会上传照片、启动 3D 任务，并在托管 MCP 服务的机器上写入 GLB 或 STL 文件。

结果是 AI 重建的网格，用于可视化和 3D 打印实验，不是工程图纸。

这是一个通过 GitHub 仓库分发的本地 stdio MCP 服务。pictostl.com 不托管远程 MCP HTTP 端点。

架构与数据流

MCP client → local pictostl-mcp process → pictostl.com API
                                      ← generation status and GLB
MCP client ← local GLB/STL file       ←

MCP 进程在本地运行，并通过 HTTPS 与 https://pictostl.com 通信。图像、生成参数和 API 密钥会发送到 pictostl.com，用于上传输入内容、创建任务和获取结果。GLB 到 STL 的转换以及最终文件写入都在运行 MCP 服务的机器上本地完成。

不存在托管的 PicToSTL MCP 端点。MCP 客户端通过 stdio 在本地启动此软件包；随后，本地进程会调用托管的 PicToSTL API。

获取 API 密钥

  1. 注册
  2. 在 API 密钥页面创建密钥
  3. 在定价页面购买额度

使用 API 或此 MCP 服务即表示你同意服务条款。

网站浏览器端的生成与 MCP 相互独立。MCP 始终使用 API 密钥。

从 GitHub 安装

需要 Node.js 20 或更高版本。以下命令通过 npm 的 Git 支持安装仓库，并运行仓库中已提交的 JavaScript 构建产物。无需发布 npm 软件包，也无需本地 TypeScript 编译器。

Claude / Cursor 配置

{
  "mcpServers": {
    "pictostl": {
      "command": "npx",
      "args": [
        "-y",
        "--package=github:qduoduo-hwh/pictostl-mcp",
        "pictostl-mcp"
      ],
      "env": {
        "PICTOSTL_API_KEY": "ps_live_..."
      }
    }
  }
}

将 PICTOSTL_API_KEY 设置为从 https://pictostl.com/settings/api-keys 获取的有效密钥。

可选：PICTOSTL_API_BASE（默认值为 https://pictostl.com），用于本地网站。

请将 API 密钥保存在 MCP 客户端的机密配置或用户级配置中。不要将有效密钥提交到源代码管理中。

如需固定安装版本，请在仓库名称后附加 Git 标签或提交，例如 github:qduoduo-hwh/pictostl-mcp#v0.1.0。

本地开发
git clone https://github.com/qduoduo-hwh/pictostl-mcp.git
cd pictostl-mcp
corepack enable
pnpm install --frozen-lockfile
pnpm build

然后配置 MCP 客户端，使用 node 运行，并将 dist/index.js 的绝对路径作为第一个参数。

工具

七个 MCP 工具：

工具用途
list_generation_options质量、纹理、多视图规则和额度成本
upload_image上传本地文件或 HTTPS URL；返回 assetId
generate_model启动异步 3D 任务（即使省略 clientRequestId，也会发送该参数）
get_task按任务 ID获取生成结果；可选参数 waitSeconds（最长 60 秒）
list_my_generations列出此 API 密钥的近期生成记录
get_account剩余额度及 Pro / Ultra 付费额度状态
download_model将原始 GLB 或本地二进制 STL 写入指定路径

典型流程：upload_image → generate_model → get_task（如果耗时超过 60 秒，则使用相同的任务 ID 重复调用）→ 使用该任务 ID调用 download_model。

不要将上传返回的 assetId 传给 get_task 或 download_model。

download_model 的默认值为 format=stl，最长边为 100 mm，由原始 GLB 在本地转换而成（不是网站预览网格）。STL 仅包含几何形状，不含颜色或纹理。format=glb 会原样写入原始文件。

重试同一任务时，请复用之前 generate_model 结果中的 clientRequestId。

贡献

改进工具描述，让 Agent 使用正确的工具和字段。不要索要内部 fal 提示词或提供商负载。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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