4dgspl.at — 4D Gaussian Splatting

io.github.snmzzcenk由 GitHub 帳號 snmzzcenk 發布v0.1.1更新於 Oct 30, 2026

Turn multi-camera video or Blender renders into 4D Gaussian Splatting (4DGS) on 4dgspl.at.

概覽

AI 產生的概覽

此 MCP 伺服器讓助理在 4dgspl.at 上準備、驗證、上傳並下載 4D 高斯潑濺專案。

可以做什麼
  • 取得 4DGS 拍攝指南,並依引擎規則檢查交付資料夾
  • 上傳多機位交付、提交處理並列出專案
  • 查詢專案狀態並下載逐格 3DGS 結果
  • 輸出為 PlayCanvas 格式的 compressed.ply 序列、含影格數、fps 與指標的場景 JSON,以及 MP4 預覽
適用情境
當你希望助理把 Blender 場景、3D 模型或多機位素材轉成 4dgspl.at 上的 4D 高斯潑濺序列,包括上傳前驗證交付內容並取回算圖結果時使用。
執行需求
以本機 stdio 程序執行,通常用 python3 執行 4dgspl_mcp.py 腳本,或在 Claude Desktop 安裝 4dgspl.mcpb 套件。上傳、查詢狀態與下載需要環境變數 DGSPL_ANAHTAR 中的代理金鑰;指南與檢查工具不需金鑰。需要連線至 4dgspl.at 的網路。
安裝前請注意
DGSPL_ANAHTAR 代理金鑰是存取你 4dgspl.at 專案的機密,請勿放入共用設定。上傳與提交會把影片和校正資料送到 4dgspl.at 處理,提交會啟動伺服器端工作。指南與檢查工具不需金鑰即可使用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 4dgspl.at — 4D Gaussian Splatting,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

4dgspl-tools

Open tools for making 4D Gaussian Splatting (4DGS) content with 4dgspl.at. Turn a 3D model, an animated character (for example from Mixamo) or a Blender scene into a synchronized multi-camera render with exact COLMAP calibration, validate it, and convert it to a 4DGS sequence that plays in the browser.

Built to be used by AI coding agents (Claude Code, Codex, …) as well as people. Agents: start with AGENTS.md.

ToolWhat it does
tools/4dgspl_blender_rig.pyBlender: builds a 4–16 camera ring (8 recommended, two heights) around the scene, renders cam00.mp4 … from every camera and writes COLMAP cameras.txt + images.txt (kalibrasyon.zip). Pure black world by default.
tools/4dgspl_yukle.pyDependency-free upload client for an agent key (DGSPL_ANAHTAR). It validates, creates a project, uploads, submits, waits and downloads the per-frame 3DGS result: --gonder --bekle --indir result.
tools/4dgspl_mcp.pyDependency-free MCP server (stdio). Claude Code, Codex, Cursor or Claude Desktop get 4dgspl.at as tools: get_4dgs_guide, check_delivery, upload_project, submit_project, project_status, list_projects, download_result.
tools/4dgspl_kontrol.pyDependency-free pre-upload checker. It checks video names, resolution, fps and frame count, the calibration format and pixel units, whether the cameras look at a common centre, height variety and ring gaps, and a black background. --json output; exit code 1 on errors.

Quick start

bash
# 1. Camera ring + render + calibration (Blender 4.x)blender -b scene.blend -P tools/4dgspl_blender_rig.py -- --kamera 8 --yaricap 3.5 --cikti //teslim --render
# 2. Validatepython3 tools/4dgspl_kontrol.py teslim
# 3. Upload, process and download with your agent key (4dgspl.at → Projelerim → Ajan anahtarları)export DGSPL_ANAHTAR=4dg_…python3 tools/4dgspl_yukle.py teslim --gonder --bekle --indir result

Real footage without a calibration file: add --colmap (8+ cameras at most 45° apart, textured scene).

Rules that matter most:

  • Background: pure black world (0, 0, 0).
  • Materials: matte.
  • Cameras: at least 6, 8 recommended; they never move.
  • Timing: the key motion within the first 10 seconds.
  • Framing: the subject fills 70–85 % of the frame height.

Details: agent guide · capture guide · examples · llms.txt

Agent skill

skills/4dgs-blender/SKILL.md packages the whole workflow as an agent skill: GLB 3D animation, video, still image and 4DGS videos from one Blender scene. To install it in Claude Code, copy the folder into ~/.claude/skills/. Agents that read SKILL.md from their own skills folder can use the same files.

MCP server

bash
mkdir -p ~/.4dgspl && cd ~/.4dgspl && curl -O https://4dgspl.at/araclar/4dgspl_mcp.py \  -O https://4dgspl.at/araclar/4dgspl_yukle.py -O https://4dgspl.at/araclar/4dgspl_kontrol.pyclaude mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py   # Claude Codecodex mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py    # Codex
  • Claude Desktop: install 4dgspl.mcpb from the latest release and enter the key in its settings.
  • Other clients: command python3, argument the path to 4dgspl_mcp.py, environment DGSPL_ANAHTAR.
  • Without a key, get_4dgs_guide and check_delivery still work.
  • Listed in the MCP Registry as io.github.snmzzcenk/4dgspl (server.json). Build the bundle with python3 mcpb/build.py.

Output

4dgspl.at reconstructs every frame as a 3D Gaussian Splatting scene (gsplat). The output is:

  • a compressed.ply sequence in PlayCanvas format;
  • sahne.json with the frame count, fps, start camera and metrics;
  • an MP4 preview.

Play the sequence in the browser with PlayCanvas, or open a single frame in SuperSplat.

Türkçe

4dgspl.at ile 4D Gaussian Splatting içeriği üretmek için açık araçlar. Blender rig betiği 4–16 kameralı halkayı kurar, her kameradan render alır ve COLMAP kalibrasyonunu yazar. Denetleyici, teslimi yüklemeden önce motorun kurallarına göre kontrol eder (--dil tr). Yapay zekâ ajanları için iş akışı: https://4dgspl.at/ajan.html

The tools in this repository are copies of https://4dgspl.at/araclar/; the site is the source and they are kept in sync. MIT license.

來源:README.md,提交 9b4d7c7

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次,以列出其工具,但未能完成:該軟體包類型無法在沙箱中執行。

版本歷史

2
  1. v0.1.1最新Oct 30, 2026
  2. v0.1.0Oct 29, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

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

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