平静-mcp服务器

Name: 平静-mcp服务器
Author: felores

作者：felores14 星标更新：2025-03-29

安装使用来源：spider==github.com

项目介绍

Placid.app MCP Server

这是一个用于与 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" }
  }
}

文档

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

许可证

MIT