# vitrine3d/mcp [Health: Active]

**Category:** 🛒 E-Commerce  
**Repository:** https://github.com/vitrine3d/mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 380  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vitrine3d-mcp

## Description
3D product viewer platform with a visual editor. Upload GLB models, style scenes with lighting, camera, and backgrounds, and embed on any website. npx @vitrine3d/mcp

## Tools
Capabilities this server exposes over MCP:

- **vitrine_list_models** — List all models with IDs, names, and publish status
- **vitrine_upload_model** — Upload a GLB file from disk
- **vitrine_model_info** — Get model details, thumbnail, and merged config
- **vitrine_delete_model** — Delete a model and its storage
- **vitrine_get_config** — Get the full scene config for a model
- **vitrine_set_config** — Apply a config patch (lighting, camera, background, effects)
- **vitrine_list_hdris** — List available HDRI environment presets
- **vitrine_config_schema** — Get the full config JSON schema
- **vitrine_publish** — Publish or unpublish a model
- **vitrine_get_embed** — Get ready-to-paste embed HTML
- **vitrine_list_looks** — List your saved Looks
- **vitrine_apply_look** — Apply a Look to a model
- **vitrine_create_look** — Save a config as a named Look
- **vitrine_account_info** — Current plan, usage, and limits
- **vitrine_login** — Connect your account via browser
- **vitrine_logout** — Remove saved credentials
- **vitrine_feedback** — Submit a bug report or feature request

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp": {
    "command": "npx",
    "args": ["-y","@vitrine3d/mcp"],
    "env": {
      "VITRINE_API_KEY": "",
      "PORT": ""
    }
  }
}
```

**Requires environment variables:** `VITRINE_API_KEY`, `PORT` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What vitrine3d/mcp MCP server does

vitrine3d/mcp MCP server connects an MCP-compatible AI client to Vitrine, a 3D product viewer platform with a visual editor. It gives an agent operations for managing GLB model assets, changing how scenes are displayed, publishing models, and producing embed HTML for websites.

Model management includes listing models with their IDs, names, and publish state; uploading a GLB file from disk; inspecting model details and thumbnails; and deleting a model together with its stored data. The account tools also expose the current plan, usage, and limits, and provide login, logout, and feedback actions.

## How it works

The server communicates with an AI client through the Model Context Protocol. In its standard mode, the client starts the package as a local stdio process. The server then communicates over HTTPS with Vitrine's API, which uses Supabase for database, storage, and authentication functions.

A separate HTTP mode is available with the `--http` flag. It serves a Streamable HTTP MCP endpoint at `/mcp`; the default port is 3000, and the `PORT` environment variable can change it. This mode is intended for MCP clients or connectors that support HTTP transport.

The server can operate without an API key for anonymous uploads, but those uploads expire after 48 hours. Signing in through the agent opens a browser and makes models permanent. An API key can also be supplied through the `VITRINE_API_KEY` environment variable.

## Setup and configuration

Add the package as a local MCP server in the client configuration:

```json
{
  "mcpServers": {
    "vitrine": {
      "command": "npx",
      "args": ["@vitrine3d/mcp"]
    }
  }
}
```

For non-interactive execution, use `npx -y @vitrine3d/mcp`. The package is documented for Claude Code, Cursor, and Windsurf configurations. To retain models beyond the anonymous 48-hour period, ask the agent to log in and complete the browser sign-in flow, or configure an API key generated from the Vitrine account settings.

To run HTTP transport locally, use `npx @vitrine3d/mcp --http`. Set `PORT` before the command when a port other than 3000 is needed.

## Tools and capabilities

The vitrine3d/mcp MCP server exposes these groups of operations:

- **Models:** list, upload, inspect, and delete GLB models.
- **Scene configuration:** read a model's complete scene configuration, apply patches for lighting, camera, background, and effects, list HDRI environment presets, and retrieve the configuration schema.
- **Publishing:** publish or unpublish models and retrieve ready-to-paste embed HTML.
- **Looks:** list saved Looks, apply one to a model, or save a configuration under a name.
- **Account:** inspect plan and usage information, sign in or out, and submit bug reports or feature requests.

The server also provides MCP resources for the scene configuration schema, HDRI presets, and an embed template. These resources can help an agent determine valid configuration fields and available environment options before changing a scene.

## Limitations and notes

The material describes GLB upload support; it does not document support for other model formats. Anonymous uploads are temporary and expire after 48 hours, so persistent model management requires browser login or an API key. The documentation does not specify plan limits beyond making account usage and limits available through a tool.

HTTP transport requires an MCP client or connector that supports Streamable HTTP. The local stdio setup is the documented default. The project is released under the MIT license.

_Full upstream README: https://allmcps.com/mcp/vitrine3d-mcp/readme_