Creative Constraints

@pipeworx/creative-constraints

分野を問わず使える創造的制約を集めた、オリジナルの162枚のカードデッキです。各カードには、エージェントやチームがどのようなタスク（製品のローンチ、エッセイ、オンボーディングフロー、夕食など）にも適用できる命令文が1文と、それが役立つ理由を説明する文が1文記載されています。意味と解釈は分けて返されます。ツールが返すのは、引いたカードと使用した手順であり、それをどう活用するかは呼び出し元のエージェントが判断します。

Pipeworx の一部です。AI エージェントを1866以上の稼働中データソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認や公開も受けていません。

Pipeworx の「chance」ファミリーの一部です。共通のシード付き RNG とセッションエンジンを使用しており、dice-roller、tarot、i-ching、random-tables でも使われています（docs/chance-packs-plan.md を参照）。

ツール

• draw_constraint(count?, categories?, seed?, session_id?) — 1～10枚のカードを引きます。9つのカテゴリのうち1つ以上に絞ることもできます。seed を指定すると、後でまったく同じカードを再現できます（同じシード、枚数、カテゴリであれば、常に同じカードが返されます）。省略すると新たにランダムに引き、実際に使用されたシードが返されます。前の応答の session_id を渡すと、重複なしのセッションを継続できます（呼び出しをまたいで、引いたカードを戻さずに抽選します）。
• list_constraint_categories() — 9つのカテゴリを、それぞれのカード枚数とタイトルの例1つとともに一覧表示します。
• get_constraint(id) — IDを指定して特定のカードを1枚取得します（例："inversion_03"）。

認証

キーは不要です。上流 API もサードパーティ依存関係もありません。

データソース

• Pipeworx — オリジナルの創造的制約デッキです。すべてのカードのタイトル、制約文、根拠はこのパックのために書かれており、パブリックドメインや商用の基盤はありません（tarot の Rider–Waite–Smith の伝統や i-ching の Legge 翻訳とは異なります）。

9つのカテゴリ

perspective、limitation、medium、time、audience、inversion、scale、process、wildcard — 各18枚、合計162枚です。

セッションはホスト環境限定です

draw_constraint の session_id 機能は、ゲートウェイの KV キャッシュバインディング（このパックのマニフェスト行で injectCacheKv: true）に依存します。公開されている npm スタンドアロン版にはこのバインディングがないため、そこで session_id を指定した場合（またはゲートウェイのキャッシュを持たない呼び出し元から指定した場合）、応答の session_supported: false によって示され、通常のシード付き抽選に切り替わります。シードによる再現性は完全に保たれますが、呼び出しをまたいだ重複なしの抽選にはなりません。セッションは24時間操作がないと期限切れになります。

再現性

すべての抽選はシード付きです。seed を省略すると、新たにランダムに抽選されます（使用されたシードは必ず meta.seed に返されます）。そのシードを同じ count と categories とともに渡すと、まったく同じカードを再現できます。session_id を使って既存のセッションを継続する場合、セッション開始時に設定されたカテゴリフィルターが保持され、その呼び出しでは categories は無視されます。

エラー

categories に未知のカテゴリを指定すると、有効なカテゴリ一覧を含むエラーが返されます。get_constraint に未知の id を指定すると、IDの命名規則を含むエラーが返されます。期限切れまたは未知の session_id を指定すると、新しいセッションを開始するには省略するよう案内するエラーが返されます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "creative-constraints": {
      "url": "https://gateway.pipeworx.io/creative-constraints/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/creative-constraints/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize 応答に正確なスコープが記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図した動作であり、意図しない多重化ではありません。メタツールを使えば、このパックが対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx 経由で回答できます。そのため、2 つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1866 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/draw_constraint \
  -H 'Content-Type: application/json' \
  -d '{"categories":["inversion"],"count":3,"seed":"pipeworx-demo"}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/draw_constraint を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です。

{
  "mcpServers": {
    "creative-constraints": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-creative-constraints"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-creative-constraints

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Creative Constraints data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT