内容
<p align="center">
<a href="https://three.ws"><img src="https://three.ws/three-ws-mcp-icon alt="three.ws" width" height="88"></ap>
<h1 align="center-ws/scene-mh1>
<p align="center>用语言创造3 — 通过任意AI代理将转化为可放置的微缩strong></p>
<p align">
<a href="www.npmjs.com/package/@three-ws/scene-mcp"><img alt" src="https://img.shields.io/npm/v/@three-ws/scene-mcp?logo=npm3837"></a <img alt="license"https://img.shields.io/npmthree-ws/scene-mcolor=3b82">
<img alt="node" src="https://img.shields/v/@three-ws/sccp?color=339933.js">
<a href="https://registry.modelcontextprotocol.io=io.github.nirholas alt="MCP Registry="https://img.shields.io/badge/MCP%20Registry-ioirholas-0ea5e9"></a>
<="https://three.ws"><="three.ws" src=".shields.io/badge/built%20by-three.ws-000"></a>
</p>
---
>模型上下文协议](https://.io) 服务器，为任意AI助手提供 three.ws **微缩模型** 流水线，通过标准。描述一个世界，用一句话，_scene` 返回一个可计划 — 情绪、调色板、地面和一组单一造提示 — 准备好构建成一个可轨道的3D场景。通过 `get_scene` 和 `list_scenes` 浏览已保存的世界。
这是与 three.ws 人物一句话的配套工具：人物为您提供一个 *角色*；场景为您提供一个 *世界*。无需API密钥，无需签名，无需付款 — 每次调用都直接命中公共 `/api/diorama` 端点。
## 安装
```bash
npm install @three-ws/scene-mcp
```
或使用 `npx` 运行（无需安装）：
```bash
npx @three-ws/scene-mcp
```
## 快速开始
**Claude 代码**，一行：
```bash
claude mcp add scene -- npx -y @three-ws/scene-mcp
```
**Claude 桌面版 / Cursor**（`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"scene": {
"command": "npx",
args": ["-y", "@three-ws/scene-m }
}
}
```
使用MCP检查器检查表面```bash
npx -y @modelcontextprotocol/inspectorthree-ws/scene-mcp
```
## 工具
| 工具 | 类型 | 功能 |
| --------------- | ----------- | ----------------------------------------------------------------------------------------------------------------- |
_scene` | 生成式 一句话 → 微缩模型标题、情绪、调、地面和2-8放置的单一对象锻造提示。 |
| `get | 只读 |已保存的世界（带有 URL）和其可轨道器URL。 |
list_scenes` | | 浏览最近或微缩模型画廊 |
`compose_scene` *计划* — 不会网格，也不会保存。api/forge` 每个对象，然后 `POST /iorama {action:"save"}` 在 `https://threeiorama?id=…`一个可分享的永久### 输入参数
**``** — `prompt`，3-1024字符世界的句子）。
**_scene`** — `id`：保存时返回的模型ID）。
**`list_scenes`** — `list`recent` | `featured默认为 `recent`），`limit`（1-50，默认为 24）。
## 示例
c
// compose_scene { "prompt": "一个雨的悬崖上的灯塔，黄昏时分" }
{
"ok": true "diorama": {
"title": "黄灯塔",
" "dusk",
" "stone",
"island": "craggy",
palette": { "sky":2b2350",76b4a"],": "#5b5560fog": "#3a3550", "accent": "#ffb" },
"objects": [
{ "id": "obj-0", "label": "lighthouse", "prompt": "白色和红色条纹的石头灯塔", "position": [0, 0, 0], "scale": 2.2, "rotationY": 0, "status": "pending", "glbUrl": null }
]
},
"": 1,
viewer_base": "three.ws/diorama"
}
```
## 要求
- **Node.js >= - 可以访问 `https.ws`（或您自己的 `THREE_WS_BASE`）。
### 环境变量
| 变量 | 是否必填 | 默认值 |
| --------------------- | ---------- |
| `THREE_WS | 否 | `https://three.ws` `THREE_WS_TIMEOUT_MS 否 | `450 |
## 链接
：https://three.ws 更新日志：https://angelog
- 问题://github.com/nirholthree.ws/issues
- 许可证：Apache-2.0LICENSE](./LICENSE)
align="center">
>
three.ws SDK 套件 3D代理、链上身份支付。<br/>
<a href="https://three.ws">网站</a> · <="https://three.ws/changelog">更新日志</a> · <a href="https://github.com/nirholas/threeGitHub</a>
sub>
</p>
许可证
Copyright © 2026 nirholas. All rights reserved.
本软件为专有软件 — 见 [LICENSE](./LICENSE)。 未经版权所有者明确书面许可，不得授予任何权利。
