Placid.app MCP サーバー

Placid.app APIと統合するためのMCPサーバー実装。このサーバーは、モデルコンテキストプロトコル（MCP）を介してテンプレートの一覧表示や画像・動画生成を行うツールを提供します。

特徴

• フィルタリングオプション付きの利用可能な Placid テンプレートを一覧表示します

• テンプレートと動的コンテンツを使用して画像とビデオを生成する

• 安全なAPIトークン管理

• エラー処理と検証

• 型安全な実装

Related MCP server: MCP TemplateIO

要件: 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. 設定 > API へ移動

3. 「APIトークンを作成」をクリックします

4. トークンに名前を付けます（例：「MCP Server」）

5. 生成されたトークンをコピーする

6. 上記のようにトークンを設定に追加します

発達

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

ツール

平易なリストテンプレート

利用可能なPlacidテンプレートの一覧とフィルタリングオプションが表示されます。各テンプレートには、タイトル、ID、プレビュー画像のURL、利用可能なレイヤー、タグが含まれます。

パラメータ

• collection_id (オプション): コレクションIDでテンプレートをフィルタリングします

• custom_data （オプション）: カスタム参照データでフィルタリング

• tags (オプション): テンプレートをフィルタリングするタグの配列

応答

それぞれ次の内容を含むテンプレートの配列を返します。

• uuid : テンプレートの一意の識別子

• title : テンプレート名

• thumbnail : プレビュー画像のURL（利用可能な場合）

• layers : 利用可能なレイヤーの名前とタイプの配列

• tags : テンプレートタグの配列

穏やかなビデオ生成

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（ステータスが「完了」の場合）

• 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 テンプレートとテキストや画像などの動的コンテンツを組み合わせて静的画像を生成します。

パラメータ

• template_id (必須): 使用するテンプレートのUUID

• layers （必須）: テンプレート レイヤーの動的コンテンツを含むオブジェクト

  • テキストレイヤーの場合: { "layerName": { "text": "Your content" } }

  • 画像レイヤーの場合: { "layerName": { "image": "https://image-url.com" } }

応答

次の内容を含むオブジェクトを返します:

• status : 完了すると「完了」

• 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 ドキュメントをご覧ください。

ライセンス

マサチューセッツ工科大学