Placid MCP Server

Placid.app MCP服务器

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

特性

• 列出可用的Placid模板及其过滤选项
• 使用模板和动态内容生成图像和视频
• 安全的API令牌管理
• 错误处理和验证
• 类型安全实施

要求：Node.js

1. 从以下位置安装Node.js（版本18或更高）和npm
2. 验证安装：

   node --version
   npm --version

安装

快速入门（推荐）

最简单的入门方法是使用Smithery，它将自动为您配置所有内容：

npx -y @smithery/cli install @felores/placid-mcp-server --client claude

手动配置

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

{
  "mcpServers": {
    "placid": {
      "command": "npx",
      "args": ["@felores/placid-mcp-server"],
      "env": {
        "PLACID_API_TOKEN": "your-api-token"
      }
    }
  }
}

获取您的Placid API代币

1. 登录到您的 Placid.app 账户
2. 前往“设置”>“API”
3. 点击“创建API令牌”
4. 为您的令牌命名（例如“MCP服务器”）
5. 复制生成的令牌
6. 将令牌添加到配置中，如上所示

发展

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

工具

plaid_list_templates

列出具有过滤选项的可用Placid模板。每个模板都包含其标题、ID、预览图像URL、可用层和标签。

参数

• collection_id （可选）：按集合ID筛选模板
• custom_data （可选）：按自定义参考数据筛选
• tags （可选）：用于筛选模板的标签数组

响应

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

• uuid：模板的唯一标识符
• title：模板名称
• thumbnail：预览图像URL（如果可用）
• layers：可用图层及其名称和类型的数组
• tags：模板标签数组

plaid_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 （可选）：设置为“自动”以将音频调整为视频长度
• 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模型的示例用法

{
  "template_id": "template-uuid",
  "layers": {
    "MEDIA": { "video": "https://example.com/video.mp4" },
    "PHOTO": { "image": "" },
    "LOGO": { "image": "" },
    "HEADLINE": { "text": "My Video Title" }
  },
  "audio": "https://example.com/background.mp3",
  "audio_duration": "auto"
}

plaid_generate_image

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

参数

• template_id （必需）：要使用的模板的UUID
• layers （必填）：包含模板图层动态内容的对象

- 对于文本图层： { "layerName": { "text": "Your content" } } - 对于图像层： { "layerName": { "image": "https://image-url.com" } }

响应

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

• status：完成时为“已完成”
• image_url：下载生成的图像的URL

LLM模型的示例用法

{
  "template_id": "template-uuid",
  "layers": {
    "headline": { "text": "Welcome to My App" },
    "background": { "image": "" }
  }
}

文档

有关普莱西德API的更多详细信息，请访问 Placid API文档.

许可证

麻省理工学院