pictostl

Conversor de imagem para STL para impressão 3D. Envie, visualize, baixe. 2 créditos gratuitos após verificação.

Documentação

pictostl-mcp

Servidor MCP stdio local para pictostl.com. A geração é executada no pictostl.com — este pacote envia fotos, inicia trabalhos 3D e grava arquivos GLB ou STL na máquina que hospeda o servidor MCP.

Os resultados são malhas reconstruídas por IA para visualização e experimentos de impressão 3D. Não são desenhos de engenharia.

Este é um servidor MCP stdio local distribuído a partir do seu repositório GitHub. O pictostl.com não hospeda um endpoint MCP HTTP remoto.

Arquitetura e fluxo de dados

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

O processo MCP é executado localmente e se comunica com https://pictostl.com via HTTPS. Imagens, parâmetros de geração e a chave de API são enviados ao pictostl.com para enviar entradas, criar trabalhos e recuperar resultados. A conversão GLB para STL e a gravação final dos arquivos acontecem localmente na máquina que executa o servidor MCP.

Não há endpoint MCP PicToSTL hospedado. Os clientes MCP iniciam este pacote localmente via stdio; o processo local então chama a API PicToSTL hospedada.

Obtenha uma chave de API

Cadastre-se
Crie uma chave em Chaves de API
Compre créditos em Preços

Ao usar a API ou este servidor MCP, você concorda com os Termos de Serviço.

A geração pelo navegador do site é separada do MCP. O MCP sempre usa uma chave de API.

Instalação a partir do GitHub

Requer Node.js 20 ou mais recente. O comando abaixo instala o repositório através do suporte Git do npm e executa seu build JavaScript versionado. Não requer um pacote npm publicado ou um compilador TypeScript local.

Configuração do Claude / Cursor

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

Defina PICTOSTL_API_KEY com uma chave ativa de https://pictostl.com/settings/api-keys.

Opcional: PICTOSTL_API_BASE (padrão https://pictostl.com) para um site local.

Mantenha a chave de API na configuração secreta ou de nível de usuário do seu cliente MCP. Não envie uma chave ativa para o controle de versão.

Para uma instalação fixada, acrescente uma tag Git ou commit após o nome do repositório, por exemplo github:qduoduo-hwh/pictostl-mcp#v0.1.0.

Desenvolvimento local

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

Em seguida, configure o cliente MCP para executar node com o caminho absoluto para dist/index.js como seu primeiro argumento.

Ferramentas

Sete ferramentas MCP:

Ferramenta	Finalidade
`list_generation_options`	Qualidade, textura, regras de múltiplas vistas e custos de crédito
`upload_image`	Envia um arquivo local ou URL HTTPS; retorna `assetId`
`generate_model`	Inicia um trabalho 3D assíncrono (envia `clientRequestId` mesmo se você omitir)
`get_task`	Busca uma geração pelo id da tarefa; `waitSeconds` opcional (máx. 60)
`list_my_generations`	Lista gerações recentes para esta chave de API
`get_account`	Créditos restantes e status de créditos pagos Pro / Ultra
`download_model`	Grava o GLB original, ou um STL binário local, em um caminho

Fluxo típico: upload_image → generate_model → get_task (repita com o mesmo id de tarefa se demorar mais de 60 segundos) → download_model com esse id de tarefa.

Não passe um assetId de envio para get_task ou download_model.

O padrão de download_model é format=stl, maior aresta 100 mm, convertido localmente a partir do GLB original (não da malha de visualização do site). O STL tem apenas geometria — sem cor ou texturas. format=glb grava o arquivo original inalterado.

Reutilize clientRequestId de um resultado anterior de generate_model ao tentar novamente o mesmo trabalho.

Contribuindo

Melhore as descrições das ferramentas para que os agentes chamem a ferramenta certa com os campos certos. Não peça prompts internos da fal ou payloads do provedor.

Licença

MIT