MCP 服务器

Placid MCP Server

一个用于与 Placid.app 的 API 集成的服务器，它能够列出模板，并使用模型上下文协议生成创意内容，同时提供安全的 API 令牌管理。

Tools

placid_list_templates

Get a list of available Placid templates with optional filtering. Each template includes its title, ID, preview image URL, available layers, and tags.

placid_generate_image

Generate an image using a template and provided assets

placid_generate_video

Generate a video using one or more templates and provided assets. Every 10 seconds of video uses 10 credits.

README

Placid.app MCP 服务器

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

功能

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

要求：Node.js

从 nodejs.org 安装 Node.js（版本 18 或更高版本）和 npm
验证安装：
```
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 令牌

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

开发

# 以热重载模式运行开发模式
npm run dev

# 运行测试
npm test

工具

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：当前状态（“finished”、“queued”或“error”）
video_url：用于下载生成的视频的 URL（当状态为“finished”时）
job_id：用于在 Placid 仪表板中检查状态的 ID（对于较长的视频）

LLM 模型的使用示例

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

placid_generate_image

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

参数

template_id（必需）：要使用的模板的 UUID
layers（必需）：包含模板图层动态内容的对象
- 对于文本图层：{ "layerName": { "text": "Your content" } }
- 对于图像图层：{ "layerName": { "image": "https://image-url.com" } }

响应

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

status：完成时为“finished”
image_url：用于下载生成的图像的 URL

LLM 模型的使用示例

{
  "template_id": "template-uuid",
  "layers": {
    "headline": { "text": "Welcome to My App" },
    "background": { "image": "https://example.com/bg.jpg" }
  }
}