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 分