mcpField
P
paraplex-mcp

paraplex-mcp

本地服务
github.com/Paraplex-AI媒体与设计02 周前更新
代码仓库

关于 paraplex-mcp

paraplex-mcp 将 MCP 客户端连接到已打开的 Paraplex 浏览器标签页，让 Agent 创建和编辑 3D 动态设计场景、查看画面并导出作品。

主要功能

  1. 01查看场景与图层
  2. 02构建和编辑场景
  3. 03使用模板或空白项目
  4. 04预览指定时间的画面
  5. 05导出 PNG 和视频
  6. 06导入 HyperFrames 项目

适用场景

  1. 01根据提示词创建动态设计场景
  2. 02在 Paraplex 标签页调整关键帧
  3. 03编辑场景时检查画面
  4. 04导出完成的视频

MCP 相关

它向 MCP 客户端提供场景查看、编辑、预览、导入、保存和导出工具，并通过一次性代码在本机连接 Paraplex 标签页。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "ai-paraplex-paraplex": {
      "command": "npx",
      "args": [
        "-y",
        "paraplex-mcp"
      ]
    }
  }
}
启动命令npx -y paraplex-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmparaplex-mcp0.2.1

工具

15

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

paraplex-mcp

将 Claude Code — 或任意 MCP 客户端 — 连接到你已打开的 Paraplex 标签页。Paraplex 是一款基于浏览器的 3D 动态设计工作室，内置 AI 助手，可编辑实际图层和关键帧。借助此服务，你终端中的 Agent 可以使用与助手相同的工具，在标签页中创建和修改场景、随时查看画面并导出。

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

然后让 Claude Code 制作一段作品 — “一段 10 秒的发布视频，包含三张玻璃卡片和我们的 logo” — 它会告诉你如何连接：

  1. 在 https://app.paraplex.ai 打开 Paraplex。
  2. 点击 菜单 › 连接 Agent，输入 Claude Code 提供的端口和六位数代码。

Agent 连接期间，标签页中会显示横幅；你可以随时在那里断开连接。

功能

工具功能
connection查看是否已连接标签页；如果没有，提供端口和代码
scene查看已打开的场景：画布、时长、时间和所有图层
list_tools、run_tool查看助手可用的操作（build_scene、add_text、set_keyframes、add_camera_move…）并运行操作
list_templates、apply_template、new_project从模板或空白文件开始
set_time、frame、frames、export_png随时查看作品画面，呈现方式与导出时相同
scene_facts查看每个图层在画面中的位置、画面中的文字大小以及摄像机信息
export_video将视频导出到此电脑上的文件（./paraplex-exports，或 PARAPLEX_OUT_DIR）
import_hyperframes从此电脑上的文件夹或 .zip 导入 HyperFrames 项目：一个代码图层及其时间线上的音效
save_project将场景保存为浏览器中的项目

每次编辑都会作为一个撤销步骤应用到标签页中，因此你可以逐步撤销 Agent 的任何操作。

隐私与安全

  • 服务仅监听此电脑上的端口（47821；可通过 npx paraplex-mcp 48000 指定其他端口）。
  • 只有 Paraplex 页面可以连接，且必须使用一次性代码。
  • 不会向其他任何地方发送数据：场景保留在你的标签页中，导出文件写入运行服务的目录。
  • Paraplex 内使用的 AI 按照你的 Paraplex 套餐照常计量；Agent 使用的模型则是 Claude Code 自己的模型。

浏览器

Chrome、Edge 或 Arc（其他浏览器可能不允许网站访问你的电脑）。如果浏览器询问是否允许 app.paraplex.ai 连接到本地网络上的设备，请允许：这就是此服务。

许可证

MIT © Paraplex Digital, LLC

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。