Terrarium

io.github.nelsonsantryhkd由 GitHub 帳號 nelsonsantryhkd 發布v0.1.0更新於 Oct 25, 2026

Human visual review for agent-built HTML: publish artifacts, pull anchored comments, push fixes.

已驗證Streamable HTTP可網頁執行開發者工具溝通與協作

概覽

AI 產生的概覽

Terrarium 代管代理程式產生的 HTML 成品,供人在瀏覽器中審閱;代理程式透過 MCP 取得錨定留言並推送修正

可以做什麼
列出並發布 HTML 成品,取得指定成品的詳細資料與目前版本狀態。取得結構化審閱回饋,包含具類型的留言串、文字錨點與回覆鏈。修正後推送成品的新版本。回覆留言並將留言標記為已解決,完成審閱循環。
適用情境
適合代理程式產出 HTML 頁面或報告、需要人工在定稿前審閱,並希望回饋以結構化、錨定到特定段落的留言形式回到代理程式的場景。
執行需求
位於 tryterrarium.com 的遠端 Streamable HTTP 端點,需要網路連線。使用 OAuth 驗證,Authorization 標頭攜帶 Bearer 個人存取權杖;README 說明權杖在服務商的 connect 頁面產生,並以 TERRARIUM_PAT 提供。隱含需要 Terrarium 帳號。
安裝前請注意
Authorization 標頭攜帶個人存取權杖,應視為機密保管,避免出現在日誌或共用設定中。此伺服器會發布成品、推送版本、回覆留言與解決留言,這些操作都會改變人工審閱者可見的狀態。成品內容由第三方代管。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Terrarium,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.nelsonsantryhkd%2Fterrarium/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "terrarium": {
      "type": "http",
      "url": "https://www.tryterrarium.com/api/mcp"
    }
  }
}

README

Terrarium plugin for Claude Code

Give your agent a place to show its work to humans. Terrarium hosts the HTML your agent builds; humans review it in the browser with comments anchored to exact passages; the agent pulls that feedback over MCP, pushes fixes, and repeats until approved.

Install

/plugin marketplace add nelsonsantryhkd/terrarium-plugin/plugin install terrarium@terrarium

Then mint a token at tryterrarium.com/connect and make it available as TERRARIUM_PAT:

sh
export TERRARIUM_PAT="samus_pat_…"

(Or just ask your agent to set Terrarium up — the bundled skill walks it through the whole flow, including sending you to /connect for the token.)

What it ships

  • MCP server (.mcp.json) — Terrarium's remote server over Streamable HTTP with 7 tools: list_artifacts, publish_artifact, get_artifact, pull_comments, push_version, reply_to_comment, resolve_comment.
  • Skill (skills/terrarium/) — teaches the publish → review → fix loop, including the terrarium-feedback/1 payload, expectedVersion freshness, and comment-thread etiquette.

The protocol

pull_comments returns a versioned, structured payload (terrarium-feedback/1) designed to be stable enough to build agents against: review state, typed comment threads (change_request / question / bug), text anchors with live resolution status, and reply chains. Evolution within /1 is additive-only.

來源:README.md,提交 25730a8

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。