Paraplex Mcp

ai.paraplex由 paraplex.ai 发布v0.3.0更新于 Nov 3, 2026

Build and edit 3D motion design scenes in your open Paraplex tab, look at frames, and export.

已验证STDIO仅桌面开发者工具媒体与设计

概览

AI 生成的概览

把 MCP 客户端连接到已打开的 Paraplex 浏览器标签页,让助手构建和编辑 3D 动态设计场景、查看画面并导出文件。

可以做什么
  • 检查并连接已打开的 Paraplex 标签页,读取场景、图层、时间与版面信息
  • 从空白项目或内置模板开始,列出并运行编辑器自身的编辑工具,如 build_scene、add_text、set_keyframes、add_camera_move
  • 移动播放头,以单帧、多帧、PNG 静帧或审阅表与多画板检查查看作品
  • 导出图片或视频,可设格式、缩放、帧率、时间区间与透明背景,并按数据行批量渲染变体
  • 导入本地文件(图片、视频、音频、3D 模型、Lottie、Figma 画框、SVG、字体)与 HyperFrames 项目
  • 管理项目、设计系统与技能,并撤销或重做编辑
适用场景
适合已经在 Paraplex 中工作、希望用终端里的智能体在自己的标签页中起草、修改并导出动态设计作品,并随时查看效果的人。它不是无头渲染器,需要受支持浏览器中打开的 Paraplex 标签页。
运行要求
以 npx 启动的本地进程(需要 Node.js)。在 Chrome、Edge 或 Arc 中打开 app.paraplex.ai,并通过菜单中的“连接智能体”输入端口和六位验证码完成连接。服务器默认监听本机 47821 端口,浏览器可能询问是否允许访问本地网络。导出文件写入 ./paraplex-exports 或 PARAPLEX_OUT_DIR 目录。
安装前请注意
智能体可以编辑、保存并覆盖标签页中的项目,也会向磁盘写入导出文件,不过每次编辑都是一个撤销步骤。它能访问该标签页中你已登录的内容。Paraplex 内部使用的 AI 按你的 Paraplex 套餐计费。只连接你信任的标签页,用完后在横幅中断开。

安装

在 SourceWeft 中

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

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

paraplex-mcp

Connect Claude Code — or any MCP client — to the Paraplex tab you have open. Paraplex is a 3D motion design studio in the browser, with an AI assistant that edits real layers and keyframes. With this server, an agent in your terminal can build and change scenes in your tab with the same tools the assistant uses, look at frames as it goes, and export.

bash
claude mcp add paraplex -- npx -y paraplex-mcp

Then ask Claude Code for a piece — "a 10-second launch video with three glass cards and our logo" — and it will tell you how to connect:

  1. Open Paraplex at https://app.paraplex.ai.
  2. Menu › Connect an agent, and enter the port and the six-digit code Claude Code gives you.

A banner shows in your tab while an agent is connected; disconnect it there any time.

What it can do

ToolWhat it does
connectionWhether a tab is attached; if not, the port and code to give you
sceneThe open scene: canvas, duration, time, every layer
list_tools, run_toolThe assistant's verbs (build_scene, add_text, set_keyframes, add_camera_move…) and running one
list_templates, apply_template, new_projectStart from a template or a blank file
set_time, frame, frames, export_pngLook at the piece at any time, as its export draws it
scene_factsWhere every layer lands in the frame, type sizes on the frame, the camera
exportExport to a file on this computer (./paraplex-exports, or PARAPLEX_OUT_DIR) with any of the Export section's options for that export only: image or video, format, scale, frame rate, part of the timeline, no background, one artboard or all, App Store / Keynote / PowerPoint / Google Slides presets. Large files stream in pieces, so there is no size ceiling
render_variantsA render per row of data (rows or CSV), each column filling the layer of its name
export_videoThe video at the scene's own settings (kept from 0.2)
import_fileSend a file from this computer into the scene, as a drop takes it: a picture or video, sound, a 3D model, Lottie, Figma frames, an SVG, a font
import_hyperframesBring in a HyperFrames project from a folder or .zip on this computer: one code layer, its sound on the timeline
undo, redoStep back or forward, as ⌘Z does
review_sheet, review_artboardsFrames across the piece as one sheet, with what runs past the frame, small or low-contrast type, and motion hitches; or the piece on 9:16, 4:5, 1:1 and 16:9
list_projects, open_project, save_projectYour projects in this browser and your account; open one, or save the scene as one
list_design_systems, apply_design_systemParaplex's design systems and yours; apply one in a single undo step
list_skills, load_skill, read_skill_file, write_skillThe assistant's skills: read them, or write one into your library

Every edit lands in your tab as one undo step, so you can step back through anything the agent did.

Privacy and safety

  • The server listens on this computer only (port 47821; pass another as npx paraplex-mcp 48000).
  • Only a Paraplex page can connect, and only with the one-time code.
  • Nothing is sent anywhere else: the scene stays in your tab, exports are written where you ran the server, and a file you send in goes only to your tab. An agent reaches only what you are signed in to in that tab.
  • AI used inside Paraplex is metered by your Paraplex plan as usual; the agent's own model is your Claude Code's.

Browsers

Chrome, Edge or Arc (other browsers may not let a website reach your own computer). If your browser asks to let app.paraplex.ai connect to devices on your local network, allow it: that is this server.

License

MIT © Paraplex Digital, LLC

来源:README.md,提交 68f2a85

工具

30

connection

Whether a Paraplex tab is attached, and if not, what to tell the person: in Paraplex, Menu → Connect an agent, then this port and code. Call it first; say the code to the person exactly.

无需输入参数。

list_templates

The built-in templates: id, label and categories (the first is its section on the home page, e.g. app-promo, brand-promo, starter, website-hero-visuals, titles-text, infographics).

无需输入参数。

new_project

A blank 1920×1080 project in the attached tab (the scene being left is saved as the editor saves it).

无需输入参数。

apply_template

Apply a built-in template by id, as the gallery does.

输入参数id必填

scene

The open scene: canvas, duration, current time, and every layer with its kind, name, clip and parent.

无需输入参数。

set_time

Move the playhead to a time in seconds.

输入参数seconds必填

frame

A picture of the frame at a time (or the current one), through the export path — the way to look at what you made.

输入参数seconds

frames

The frame at several times (default: four across the piece), one picture each.

输入参数times

list_tools

The assistant's tools — every verb that edits the scene — with their input schemas. Run one with run_tool.

无需输入参数。

run_tool

Run one of the assistant's tools in the attached tab (see list_tools), e.g. build_scene, add_text, set_property, add_camera_move — each call one undo step there.

输入参数name必填input

export_png

The scene at the current time through the export path (what a PNG export produces), as an image.

无需输入参数。

export

Export with any of the Export section's options, the files written on this computer as the tab renders them (no size limit): an image (png, jpg) at `seconds`, or a video (mp4, webm, gif, png-sequence) over `inSeconds`–`outSeconds`; `scale` 0.5–4, `fps`, `background: false` for transparency (PNG, WebM, PNG sequence); `artboard` an artboard's id or label, or "all" for one file each; `deliver` a destination's preset (app-store with `device` iphone/ipad/mac, keynote, powerpoint, google-slides). Only what you pass changes, and only for this export: the person's settings stay. `path` is a folder, or a file name for a single file (default ./paraplex-exports). A Free account gets the reason a Pro export is refused.

输入参数fpskindpathscaledeviceformatdeliversecondsartboardinSecondsbackgroundoutSeconds

render_variants

Render a variant per row, as Variants does: `rows` (objects) or `csv` (a header row, then a row per variant). Each column fills the layer named like it — its text, a counter's end value, a fill color, or a picture by its file name in the scene's media library — or the layer `bindings` maps it to (column → layer id or name). `nameColumn` names each file. Takes every option `export` takes (an image by default; kind video for a clip per row). Without rows, the sheet already set in Variants. Answers with the files and any column that bound to nothing.

输入参数csvkindpathrowsformatoptionsbindingsnameColumn

export_video

Export the scene as a video with its own settings, written to a file in the export folder (or at `path`); answers with where it went. The `export` tool takes every option.

输入参数path

import_hyperframes

Import a HyperFrames project (HeyGen's HTML-to-video format) into the attached tab: `path` is its folder (index.html at the top) or a .zip of it. The whole project becomes one code layer — nested data-composition-src files, pictures, videos, fonts and stylesheets embedded, HyperFrames' runtime driven by the playhead — and each <audio> clip a sound layer at its start. Then look at it with frames, and finish it by hand or with run_tool.

输入参数namepath必填

import_file

Bring a file from this computer into the open scene, as dropping it on the canvas does: a picture or video becomes a layer (or fills the layer `target`, by id — a card, a phone screen, a component's slot), sound a clip at the playhead, a GLB/glTF/splat a model, a .lottie or Lottie .json an animation, an SVG a vector, a TTF/OTF/WOFF a font of the scene's. Answers with what happened and the layers it added.

输入参数path必填target

undo

Undo the last `steps` edits in the tab (default 1), as ⌘Z does — a run_tool call is one step. Answers with how many it took and whether more remain.

输入参数steps

redo

Redo `steps` undone edits (default 1), as ⇧⌘Z does.

输入参数steps

review_sheet

A review sheet of the open scene, the way to judge a piece before calling it done: frames across it (default eight; or `times`) as one picture, and the flags — layers past the frame (more than 0.05 of the frame), text under 14 px on the frame, text under 3:1 contrast against what is behind it, motion hitches (a speed that jumps or a path that turns a corner mid-move). Fix what is flagged unless it is a deliberate choice you can name.

输入参数timeswidth

review_artboards

The piece on every review artboard (9:16, 4:5, 1:1, 16:9) as Responsive lays it out, at `times`: what each artboard did, what its frame cuts, the smallest type and type at the edge, with all the frames as one picture.

输入参数times

list_projects

The person's projects, newest first: those in this browser and, when the tab is signed in, those kept in their account (in the cloud), each with its id, name, when it changed, and which one is open.

无需输入参数。

open_project

Open one of the person's projects by id (list_projects), as the editor opens it: the scene being left is saved first; a project kept only in the account is fetched. Answers with its name and its scene.

输入参数id必填

list_design_systems

Design systems the person can apply: Paraplex's and their own (made, imported or installed), each with what it holds (colors, text styles, materials, looks, fonts), and the one the scene follows now.

无需输入参数。

apply_design_system

Apply a design system by id or name, as Use in project does: its colors, text styles, materials, looks and fonts merged into the scene, which then follows it. One undo step. Then build with its tokens (run_tool get_brand reads them).

输入参数id必填

list_skills

The person's skills and Paraplex's (Agent Skills: instructions and reference files), each with its description and whether it is on. Read one with load_skill when a task matches it.

无需输入参数。

load_skill

A skill's instructions (its SKILL.md body) and the files inside it, by name. Read it before doing the work it describes.

输入参数name必填

read_skill_file

One file inside a skill — a reference, a template, a checklist — by the path load_skill listed.

输入参数name必填path必填

write_skill

Write a skill's SKILL.md into the person's library: the whole file, frontmatter (name, description) then instructions. Rewrites the named skill's SKILL.md and keeps its reference files, or creates it. Paraplex's own skills are not rewritten.

输入参数name必填markdown必填

save_project

Save the open scene as a project of that browser's, by name.

输入参数name必填

scene_facts

The review's facts at a time: where every layer lands on the frame (NDC boxes, ±1 is the frame's edge), each text's size on the frame in px and its fill, the camera.

输入参数seconds必填

版本历史

2
  1. v0.3.0最新Oct 31, 2026
  2. v0.2.1Oct 14, 2026

评分

已满足适用检查项的 90%

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

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分