Placid.app MCP サーバー
Placid.app APIと統合するためのMCPサーバー実装。このサーバーは、モデルコンテキストプロトコル（MCP）を介してテンプレートの一覧表示や画像・動画生成を行うツールを提供します。
特徴
フィルタリングオプション付きの利用可能な Placid テンプレートを一覧表示します
テンプレートと動的コンテンツを使用して画像とビデオを生成する
安全なAPIトークン管理
エラー処理と検証
型安全な実装
Related MCP server: MCP TemplateIO
要件: 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 Server」）
生成されたトークンをコピーする
上記のようにトークンを設定に追加します
発達
# 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(必須): 使用するテンプレートのUUIDlayers（必須）: テンプレート レイヤーの動的コンテンツを含むオブジェクトビデオレイヤーの場合:
{ "layerName": { "video": "https://video-url.com" } }画像レイヤーの場合:
{ "layerName": { "image": "https://image-url.com" } }テキストレイヤーの場合:
{ "layerName": { "text": "Your content" } }
audio（オプション）: mp3オーディオファイルへのURLaudio_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(必須): 使用するテンプレートのUUIDlayers（必須）: テンプレート レイヤーの動的コンテンツを含むオブジェクトテキストレイヤーの場合:
{ "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 ドキュメントをご覧ください。
ライセンス
マサチューセッツ工科大学