Spacery

io.github.lukehollis由 GitHub 账号 lukehollis 发布v0.2.3更新于 Oct 24, 2026

将3D扫描、高斯泼溅和360度全景导览发布为可分享的空间，并在其中构建导览路线

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Publish 3D scans, Gaussian splats and 360 tours as shareable spaces, and build guided tours in them

已验证Streamable HTTP可网页运行媒体与设计

概览

Spacery 的托管 MCP 服务（app.spacery.dev）；无需登录；Streamable HTTP；18 个工具。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

端点
app.spacery.dev
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spacery，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.lukehollis%2Fspacery/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "spacery": {
      "type": "http",
      "url": "https://app.spacery.dev/mcp"
    }
  }
}

README

[Spacery]

Spacery MCP server and agent skill

Spacery hosts 3D captures as virtual spaces with guided tours, shared with a link. This repository holds the Spacery connector (an MCP server) and agent skill, so your agent can publish captures for you and build tours and scavenger hunts in them.

  • Publish E57 and other laser scans, Matterport exports, 3D Gaussian splats, 360 photos and video, meshes and photo sets as spaces, straight from your computer.
  • Build guided tours and scavenger hunts in your own spaces or Spacery's public ones (museums, temples, tombs, gardens). Spacery's tour agent writes the stops and places 3D models, effects, sound, looks (line drawing, blueprint, film noir, night vision) and skies (a sunset, a storm, the Milky Way).
  • Your account links through a code you approve in your browser. Payment goes through Stripe Checkout in your browser. The connector never sees a password or a card.

Live demos: an observatory from a Matterport E57 and a garden as 3D Gaussian splats. Free to try. Hosting from $5 a month (pricing).

Two connectors

Local connectorHosted connector
Runson your computer, over stdioon Spacery, over Streamable HTTP
Addressnpx -y https://spacery.dev/agents/spacery-0.2.3.tgzhttps://app.spacery.dev/mcp
Reads files on your computeryes, and uploads them in the background with resumeno, it takes files the agent holds and gives you a page to drop the rest on
Use it inClaude Code, Claude Desktop, Codex, Grok Build, Antigravity, Gemini CLI, Cursorclaude.ai, ChatGPT, grok.com, Meta Muse and other apps that take a connector URL

The local connector is one readable JavaScript file with no dependencies. It needs Node.js 18 or later.

Add it

Claude Code, as a plugin with the connector and the skill.

bash
claude plugin marketplace add lukehollis/spaceryclaude plugin install spacery@spacery

Or the connector alone.

bash
claude mcp add --scope user spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Claude Desktop. Download spacery.mcpb and open it.

Codex.

bash
codex mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Gemini CLI.

bash
gemini extensions install https://github.com/lukehollis/spacery

Grok Build.

bash
grok mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Antigravity.

bash
agy mcp add spacery -- npx -y https://spacery.dev/agents/spacery-0.2.3.tgz

Cursor and any other agent that reads an mcpServers config.

json
{  "mcpServers": {    "spacery": { "command": "npx", "args": ["-y", "https://spacery.dev/agents/spacery-0.2.3.tgz"] }  }}

claude.ai, ChatGPT, grok.com, Meta Muse and other apps in the cloud. Add a custom connector with the URL https://app.spacery.dev/mcp.

The skill

skills/spacery/SKILL.md teaches an agent the publishing and tour steps. Add it with

bash
npx skills add lukehollis/spacery

or save it as spacery/SKILL.md in your agent's skills folder (~/.claude/skills, ~/.agents/skills for Codex, ~/.grok/skills, ~/.gemini/config/skills for Antigravity).

Tools

ToolWhat it does
check_filesLooks at capture files and folders on this computer (local connector)
link_accountLinks the agent to your Spacery account through a code you approve in the browser
list_plansShows the ways to pay for hosting
create_spaceCreates a space and opens Stripe Checkout when hosting needs payment
wait_for_paymentWaits for Checkout to finish
upload_filesUploads a capture in the background and submits it for processing
finish_uploadSubmits files the agent uploaded itself (hosted connector)
space_statusShows upload and processing progress
set_visibilityMakes a ready space public or private
find_tour_spacesFinds your spaces and public spaces to build a tour or scavenger hunt on
create_tourStarts a guided tour or scavenger hunt on a space
draft_tourAsks Spacery's tour agent to write the tour, with models, effects, sound, looks and skies
wait_for_tourWaits for a draft and summarizes the tour
get_tour, save_tourShows a tour with everything it can use, and saves one edited by hand
search_modelsSearches the library of ready-made 3D models
upload_model, upload_skyAdds your own .glb model or 360 sky image to a tour (local connector)
list_tours, share_tourLists your tours, and shares one by link or makes it private again
unlink_accountUnlinks the agent

Try it

Ask your agent

  • "Publish the scan in ~/Captures/studio as a Spacery space."
  • "Make a scavenger hunt for five artifacts in a Spacery museum, ending in a line drawing."
  • "Model a bronze lantern in Blender and put it by the altar in my temple tour."

More

MIT licensed.

来源：README.md，提交 40a7306

工具

18

list_plans

List hosting plans

The ways to pay for hosting, with prices, and the account's current plan. The first space is a free private preview, so show them when the person wants to publish it or keep it.

无需输入参数。

create_space

Create space

Creates a space for one capture. An account that does not pay for hosting yet gets its first space as a free private preview: upload and process it with no payment. After that, it returns a Stripe Checkout link for the plan the person chose (pay as you go when none is given) for them to pay; then call wait_for_payment. Never ask for card details.

输入参数plantitle必填

wait_for_payment

Wait for payment

Waits up to 25 seconds for the person to finish paying in Stripe Checkout, whether for a space's first payment or to publish a free preview. Call it again to keep waiting.

输入参数space_id必填

upload_files

Upload files

Starts resumable uploads for capture files you hold (for example photos or video the person shared with you) and returns where to PUT each file's bytes. For files on the person's own device, give them the space's page to drop the files instead.

输入参数files必填space_id必填

finish_upload

Finish upload

Checks that every uploaded file is complete and submits the space for processing. The account is emailed when the space is ready.

输入参数notesoutputsubmitspace_id必填

space_status

Space status

Status of one space, or every space on the account with its link when ready.

输入参数space_id

set_visibility

Set space visibility

Makes a ready space public (anyone with the link) or private (only the owner). Ask the person first. A free preview cannot be public until hosting starts, so it returns a Stripe Checkout link for the person to pay.

输入参数public必填space_id必填

find_tour_spaces

Find spaces for tours

Spaces a guided tour or scavenger hunt can be built on: the person's own finished spaces and the site's public spaces (museums, temples, tombs, gardens). Search by words in the title.

输入参数query

list_tours

List tours

The tours and scavenger hunts on the account, with their links.

无需输入参数。

create_tour

Create tour

Starts a private guided tour or scavenger hunt on a space from find_tour_spaces; fill it with draft_tour or save_tour.

输入参数kindtitlescene_id必填

draft_tour

Draft tour

Asks the site's tour agent, which sees the space's photographs, to write or rework the tour from a plain request: stops and text, hidden objects and clues, library models, effects, sound, music, looks with transitions and skies (day, sunset, storm, night, stars). It places everything and saves. Returns at once; then call wait_for_tour.

输入参数request必填tour_id必填

wait_for_tour

Wait for tour draft

Waits up to 25 seconds for a draft to finish, then summarizes the tour. Call it again to keep waiting.

输入参数tour_id必填

get_tour

Get tour

The tour as JSON (stops, objects, effects, looks, skies) with its revision, for editing with save_tour.

输入参数tour_id必填

save_tour

Save tour

Saves a tour edited by hand: the experience JSON from get_tour with changes. Models use a url from search_models, or any https address of a .glb.

输入参数titletour_id必填experience必填

search_models

Search 3D models

Searches the library of ready-made 3D models (statues, amphorae, temples, furniture, animals, props from many periods). Returns each model's size and url.

输入参数limitquery必填

share_tour

Share tour

Makes a tour public (anyone with its link, never listed) or private, and optionally renames it. Ask the person first.

输入参数titlepublictour_id必填

版本历史

2
  1. v0.2.3最新Oct 20, 2026
  2. v0.2.2Oct 20, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分