Placid.app MCP Server

Placid.app MCP 服务

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

功能

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

要求：Node.js

1. 从 nodejs.org 安装 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. 前往 Settings > API
3. 点击“Create API Token”
4. 为令牌命名（例如，“MCP Server”）
5. 复制生成的令牌
6. 按照上方所示将令牌添加到配置中

开发

# Run in development mode with hot reload
npm run dev

# Run tests
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（适用于较长的视频）

大模型使用示例

{
  "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

大模型使用示例

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

文档

如需了解 Placid API 的更多详细信息，请访问 Placid API 文档。

许可证

MIT