内容
# 展示服务器
[](https://www.npmjs.com/package/@vitrine3d/mcp)
[](https://glama.ai/mcp/servers/vitrine3d/mcp)
[](LICENSE)
用于 [vitrine](https://vitrine3d.com) 的 MCP 服务器 — 3D 产品查看器平台。上传 GLB 模型，配置场景，发布嵌入代码，并通过任意 AI 代理管理外观。
## 设置
将以下内容添加到您的 MCP 客户端配置（Claude Code、Cursor、Windsurf 等）：
```json
{
"mcpServers": {
"vitrine": {
"command": "npx",
"args": ["@vitrine3d/mcp"]
}
}
}
```
无需 API 密钥即可立即使用 — 匿名上传在 48 小时后过期。
### 保留您的模型
对您的 AI 代理说 **"log me in"**。浏览器窗口打开，您登录（或免费注册），您的模型将永久保存。无需手动复制密钥。
或者手动设置 API 密钥：
```json
{
"mcpServers": {
"vitrine": {
"command": "npx",
"args": ["@vitrine3d/mcp"],
"env": {
"VITRINE_API_KEY": "vt_..."
}
}
}
}
```
在 [app.vitrine3d.com](https://app.vitrine3d.com) → 账户 → API 密钥处生成密钥。
## 您能做什么
询问您的 AI 代理：
- "上传此鞋子模型并给我一个嵌入代码"
- "使照明更暖和并添加 bloom 效果"
- "列出我的模型并发布椅子"
- "创建一个名为 'Noir' 的外观，带有黑暗背景和戏剧性照明"
## 工具
### 模型
| 工具 | 描述 |
|------|-------------|
| `vitrine_list_models` | 列出所有模型，包含 ID、名称和发布状态 |
| `vitrine_upload_model` | 从磁盘上传 GLB 文件 |
| `vitrine_model_info` | 获取模型详细信息、缩略图和合并配置 |
| `vitrine_delete_model` | 删除模型及其存储 |
### 配置
| 工具 | 描述 |
|------|-------------|
| `vitrine_get_config` | 获取模型的完整场景配置 |
| `vitrine_set_config` | 应用配置补丁（照明、相机、背景、效果） |
| `vitrine_list_hdris` | 列出可用的 HDRI 环境预设 |
| `vitrine_config_schema` | 获取完整的配置 JSON 模式 |
### 发布
| 工具 | 描述 |
|------|-------------|
| `vitrine_publish` | 发布或取消发布模型 |
| `vitrine_get_embed` | 获取可粘贴的嵌入 HTML |
### 外观
| 工具 | 描述 |
|------|-------------|
| `vitrine_list_looks` | 列出已保存的外观 |
| `vitrine_apply_look` | 将外观应用于模型 |
| `vitrine_create_look` | 将配置保存为命名外观 |
### 账户
| 工具 | 描述 |
|------|-------------|
| `vitrine_account_info` | 当前计划、使用情况和限制 |
| `vitrine_login` | 通过浏览器连接您的账户 |
| `vitrine_logout` | 删除保存的凭证 |
| `vitrine_feedback` | 提交错误报告或功能请求 |
## 资源
| 资源 | 描述 |
|----------|-------------|
| `vitrine://config-schema` | 完整的 SceneConfig JSON 模式 |
| `vitrine://hdri-presets` | 可用的 HDRI 预设 |
| `vitrine://embed-template` | 嵌入代码模板 |
## HTTP 传输
作为托管的 HTTP 服务器运行，而不是 stdio：
```bash
npx @vitrine3d/mcp --http # 默认端口 3000
PORT=8080 npx @vitrine3d/mcp --http # 自定义端口
```
服务器在 `/mcp` 处暴露一个可流式传输的 HTTP 端点，与 Smithery、Glama 连接器和任何支持 HTTP 传输的 MCP 客户端兼容。
## 工作原理
```
您 -> AI 代理（Claude、Cursor 等）
| MCP 协议（stdio 或 HTTP）
展示 MCP 服务器
| HTTPS
api.vitrine3d.com
|
Supabase（数据库、存储、身份验证）
```
## 文档
- [API 文档](https://docs.vitrine3d.com/docs/api)
- [MCP 文档](https://docs.vitrine3d.com/docs/mcp)
- [快速入门](https://docs.vitrine3d.com/docs/getting-started)
## 许可证
MIT
