pictostl

Conversor de imágenes a STL para impresión 3D. Sube, previsualiza, descarga. 2 créditos gratuitos tras la verificación.

Documentación

pictostl-mcp

Servidor MCP local stdio para pictostl.com. La generación se ejecuta en pictostl.com — este paquete sube fotos, inicia trabajos 3D y escribe archivos GLB o STL en la máquina que aloja el servidor MCP.

Los resultados son mallas reconstruidas por IA para visualización y experimentos de impresión 3D. No son dibujos de ingeniería.

Este es un servidor MCP local stdio distribuido desde su repositorio de GitHub. pictostl.com no aloja un endpoint MCP HTTP remoto.

Arquitectura y flujo de datos

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

El proceso MCP se ejecuta localmente y se comunica con https://pictostl.com a través de HTTPS. Las imágenes, los parámetros de generación y la clave de API se envían a pictostl.com para subir entradas, crear trabajos y recuperar resultados. La conversión de GLB a STL y la escritura final de archivos ocurren localmente en la máquina que ejecuta el servidor MCP.

No existe un endpoint MCP de PicToSTL alojado. Los clientes MCP inician este paquete localmente a través de stdio; el proceso local luego llama a la API alojada de PicToSTL.

Obtener una clave de API

Regístrate
Crea una clave en Claves de API
Compra créditos en Precios

Al usar la API o este servidor MCP, aceptas los Términos de servicio.

La generación en el navegador web es independiente de MCP. MCP siempre usa una clave de API.

Instalar desde GitHub

Requiere Node.js 20 o más reciente. El comando a continuación instala el repositorio a través del soporte de Git de npm y ejecuta su compilación de JavaScript confirmada. No requiere un paquete npm publicado ni un compilador TypeScript local.

Configuración de Claude / Cursor

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

Establece PICTOSTL_API_KEY con una clave activa de https://pictostl.com/settings/api-keys.

Opcional: PICTOSTL_API_BASE (por defecto https://pictostl.com) para un sitio web local.

Mantén la clave de API en la configuración secreta o a nivel de usuario de tu cliente MCP. No confirmes una clave activa en el control de versiones.

Para una instalación fija, agrega una etiqueta de Git o un commit después del nombre del repositorio, por ejemplo github:qduoduo-hwh/pictostl-mcp#v0.1.0.

Desarrollo local

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

Luego configura el cliente MCP para ejecutar node con la ruta absoluta a dist/index.js como su primer argumento.

Herramientas

Siete herramientas MCP:

Herramienta	Propósito
`list_generation_options`	Reglas de calidad, textura, múltiples vistas y costos de créditos
`upload_image`	Sube un archivo local o una URL HTTPS; devuelve `assetId`
`generate_model`	Inicia un trabajo 3D asíncrono (envía `clientRequestId` incluso si lo omites)
`get_task`	Obtiene una generación por id de tarea; `waitSeconds` opcional (máx. 60)
`list_my_generations`	Lista las generaciones recientes para esta clave de API
`get_account`	Créditos restantes y estado de créditos pagados Pro / Ultra
`download_model`	Escribe el GLB original, o un STL binario local, en una ruta

Flujo típico: upload_image → generate_model → get_task (repite con el mismo id de tarea si tarda más de 60 segundos) → download_model con ese id de tarea.

No pases un assetId de subida a get_task o download_model.

El valor predeterminado de download_model es format=stl, borde más largo 100 mm, convertido localmente desde el GLB original (no la malla de vista previa del sitio web). STL solo tiene geometría, sin color ni texturas. format=glb escribe el archivo original sin cambios.

Reutiliza clientRequestId de un resultado anterior de generate_model al reintentar el mismo trabajo.

Contribuciones

Mejora las descripciones de las herramientas para que los agentes llamen a la herramienta correcta con los campos correctos. No pidas prompts internos de fal ni cargas útiles del proveedor.

Licencia

MIT