Placid.app MCP 服务器

一个用于与 Placid.app API 集成的 MCP 服务器实现。该服务器提供用于列出模板以及通过模型上下文协议生成图像和视频的工具。

特征

• 列出可用的 Placid 模板并附带过滤选项

• 使用模板和动态内容生成图像和视频

• 安全 API 令牌管理

• 错误处理和验证

• 类型安全实现

要求：Node.js

1. 从nodejs.org安装 Node.js（版本 18 或更高版本）和 npm

2. 验证安装：

   node --version npm --version

安装

快速启动（推荐）

最简单的入门方法是使用 Smithery，它将自动为您配置一切：

手动配置

如果您希望手动配置，请将其添加到您的 Claude Desktop 或 Cline 设置中：

获取您的 Placid API 令牌

1. 登录您的Placid.app帐户

2. 转到“设置”>“API”

3. 点击“创建 API 令牌”

4. 给你的令牌命名（例如“MCP 服务器”）

5. 复制生成的token

6. 将令牌添加到您的配置中，如上所示

发展

工具

placid_list_templates

列出可用的 Placid 模板，并提供筛选选项。每个模板包含其标题、ID、预览图像 URL、可用图层和标签。

参数

• collection_id （可选）：按集合 ID 过滤模板

• custom_data （可选）：按自定义参考数据过滤

• tags （可选）：用于过滤模板的标签数组

回复

返回模板数组，每个模板包含：

• uuid ：模板的唯一标识符

• title ：模板名称

• thumbnail ：预览图像 URL（如果可用）

• layers ：可用层及其名称和类型的数组

• tags ：模板标签数组

placid_generate_video

将 Placid 模板与视频、图片和文本等动态内容相结合，即可生成视频。对于较长的视频（处理时间超过 60 秒），您将收到一个作业 ID，以便在 Placid 控制面板中查看进度。

参数

• template_id （必需）：要使用的模板的 UUID

• layers （必需）：包含模板图层的动态内容的对象

  • 对于视频层： { "layerName": { "video": "https://video-url.com" } }

  • 对于图像层： { "layerName": { "image": "https://image-url.com" } }

  • 对于文本图层： { "layerName": { "text": "Your content" } }

• audio （可选）：mp3 音频文件的 URL

• audio_duration （可选）：设置为“auto”以将音频修剪为视频长度

• audio_trim_start （可选）：修剪起点的时间戳（例如“00:00:45”或“00:00:45.25”）

• audio_trim_end （可选）：修剪结束点的时间戳（例如“00:00:55”或“00:00:55.25”）

回复

返回包含以下内容的对象：

• status ：当前状态（“完成”、“排队”或“错误”）

• video_url ：下载生成视频的 URL（状态为“完成”时）

• job_id ：用于在 Placid 仪表板中检查状态的 ID（适用于较长的视频）

LLM 模型的示例用法

placid_generate_image

通过将 Placid 模板与文本和图像等动态内容相结合来生成静态图像。

参数

• template_id （必需）：要使用的模板的 UUID

• layers （必需）：包含模板图层的动态内容的对象

  • 对于文本图层： { "layerName": { "text": "Your content" } }

  • 对于图像层： { "layerName": { "image": "https://image-url.com" } }

回复

返回包含以下内容的对象：

• status ：完成时显示“完成”

• image_url ：下载生成图像的 URL

LLM 模型的示例用法

文档

有关 Placid API 的更多详细信息，请访问Placid API 文档。

执照

麻省理工学院