Placid.app MCP Server

Placid.app MCP サーバー

Placid.app の API と連携する MCP サーバーの実装です。このサーバーは、Model Context Protocol を通じてテンプレートの一覧表示や画像・動画の生成を行うツールを提供します。

機能

• フィルタリングオプションを使用して、利用可能な 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 秒を超える長い動画の場合、Placid ダッシュボードでステータスを確認するためのジョブ ID が返されます。

パラメーター

• 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