MCP のツールとリソース

このリファレンスは、稼働中の MCP サーバーから自動生成されています。

ワークフロー

AI エージェントは、パイプラインを実行するために次のワークフローに従う必要があります:

1. list_pipelines — 利用可能なパイプラインを見つける
2. get_pipeline_schema — 選んだパイプラインの入力スキーマを取得する
3. request_upload — 必要なファイル（画像、動画、音声）をアップロードする
4. run_pipeline — 必要な入力を渡してパイプラインを実行する
5. get_pipeline_run_status — 結果を確認する（またはリアルタイム通知を待つ）

ヒント

run_pipeline を呼び出すと、サーバーは自動的にステータス更新を購読します。パイプラインが pending → running → completed（または failed）へと進むにつれて、アシスタントは notifications/pipeline/status を受け取ります。

---

ツール

list_pipelines

利用可能なすべての AI 動画・画像パイプラインを一覧表示します。アクティブな各パイプラインについて、名前、スラッグ、説明、カテゴリ、クレジットコスト、必要なプロバイダーを返します。

パラメーター: なし

---

get_pipeline_schema

特定のパイプラインの入力スキーマを取得します。必須および任意の入力フィールドを記述した JSON Schema を返します。パイプラインを実行する前にこれを使って、どのような入力が必要かを把握してください。

パラメーター:

名前	型	必須	説明
pipeline_slug	string	はい	パイプラインのスラッグ識別子（例: ‘image-generator’、‘video-generator’）

---

run_pipeline

指定した入力を渡して、スラッグで AI パイプラインを実行します。利用可能なパイプラインを見つけるには list_pipelines を、必要な入力を確認するには get_pipeline_schema を使ってください。ステータス追跡用の実行 ID を返します。

パラメーター:

名前	型	必須	説明
input	object	はい	JSON オブジェクトとしてのパイプライン入力フィールド。各パイプラインの必須フィールドを確認するには get_pipeline_schema を使ってください。
pipeline_slug	string	はい	実行するパイプラインのスラッグ識別子（例: ‘image-generator’、‘video-generator’）

---

get_pipeline_run_status

パイプライン実行のステータスを確認します。ステータス（pending/running/completed/failed）、出力データ、エラーメッセージ、タイムスタンプ、生成されたアセットの URL を返します。

パラメーター:

名前	型	必須	説明
run_id	string	はい	run_pipeline が返したパイプライン実行 ID

---

request_upload

ファイル用の署名付き S3 アップロード URL をリクエストします。ファイル URL を必要とするパイプライン入力（例: 画像、動画、音声）に使用します。

2 段階のアップロードフロー:

1. filename と content_type を指定してこのツールを呼び出し、署名付きアップロード URL と最終的なアセット URL を取得します
2. ファイルの内容を upload_url に PUT します（署名付き、5 分で失効）
3. パイプラインの実行時に、asset_url を入力値として使用します

サポートされるコンテンツタイプ: image/（最大 10MB）、video/（最大 50MB）、audio/*（最大 20MB）

パラメーター:

名前	型	必須	説明
content_type	string	はい	ファイルの MIME タイプ（例: ‘image/jpeg’、‘image/png’、‘video/mp4’、‘audio/mpeg’）
filename	string	はい	アップロードするファイルの名前（例: ‘photo.jpg’、‘video.mp4’）

---

---

リソース

billing://balance

クレジット残高

利用可能なクレジットと予約済みクレジットを含む、現在のクレジット残高。

MIME タイプ: application/json

---

billing://history

クレジット履歴

購入、使用、返金を示すクレジット取引履歴。

MIME タイプ: application/json

---

assets://list

アセット一覧

生成したアセット（画像、動画、音声）を一覧表示します。パイプライン実行によるすべてのアセット。

MIME タイプ: application/json

---

assets://get/{asset_id}

アセット取得

ID で特定のアセットの詳細（メタデータとダウンロード URL を含む）を取得します。

MIME タイプ: application/json

---

assets://list/{type}

タイプ別アセット一覧

生成したアセットをタイプ（image、video、audio）で絞り込んで一覧表示します。

MIME タイプ: application/json

---

---

リアルタイム通知

パイプラインを実行すると、MCP サーバーは自動的にステータス更新を購読します。通知はメソッド notifications/pipeline/status を使用します:

{
  "method": "notifications/pipeline/status",
  "params": {
    "run_id": "uuid",
    "status": "completed",
    "pipeline_name": "Pipeline Name",
    "pipeline_slug": "pipeline-slug",
    "assets": [
      {
        "id": "uuid",
        "url": "https://s3.pipe2.ai/assets/...",
        "type": "image"
      }
    ]
  }
}

ステータス値: pending、running、completed、failed、cancelled