Placid.app MCP Server

基本能力

产品定位

Placid.app MCP Server 主要用于与 Placid.app 的 API 集成，提供模板管理和创意内容生成的功能。

核心功能

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

适用场景

• 需要动态生成创意内容的应用程序
• 需要集成 Placid.app 模板的系统
• 需要自动化内容生成的工作流程

工具列表

1. placid_list_templates
2. 功能：列出可用的 Placid 模板，支持通过 collection_id、custom_data 和 tags 过滤。
3. 参数：
   • collection_id (可选): 按集合 ID 过滤模板
   • custom_data (可选): 按自定义参考数据过滤
   • tags (可选): 按标签数组过滤模板

4. 响应：返回模板数组，包含 UUID、标题、缩略图 URL、可用图层和标签。

5. placid_generate_creative

6. 功能：通过结合 Placid 模板和动态内容（如文本和图像）生成创意内容。
7. 参数：
   • template_id (必需): 使用的模板 UUID
   • layers (必需): 包含模板图层动态内容的对象
   • modifications (可选): 自定义输出（如宽度、高度、文件名）
8. 响应：返回包含状态、图像 URL 和使用的信用数的对象。

常见问题解答

• 如何获取 Placid API 令牌？
• 登录 Placid.app 账户
• 转到设置 > API
• 点击“创建 API 令牌”
• 为令牌命名（如“MCP Server”）
• 复制生成的令牌
• 将令牌添加到 Claude Desktop 或 Cline 配置中

使用教程

使用依赖

• 需要安装 Node.js 和 npm

安装教程

通过 Smithery 安装

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

通过 NPX 安装

npx @felores/placid-mcp-server

手动安装

1. 克隆仓库:

git clone https://github.com/felores/placid-mcp-server.git
cd placid-mcp-server

1. 安装依赖:

npm install

1. 构建项目:

npm run build

调试方式

# 开发模式运行（带热重载）
npm run dev

# 运行测试
npm test

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。