Creative Constraints

@pipeworx/creative-constraints

从一副原创的 162 张领域中立创意约束卡牌中抽取内容——每张卡牌包含一句祈使句，Agent 或团队可以将其应用于任何任务（产品发布、文章、入门流程、晚餐等），以及一句说明其作用的理由。含义与解读分开返回：工具会提供抽到的内容和所用的流程，由调用方 Agent 决定如何处理。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 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 张卡牌，可选择限制为九个类别中的一个或多个。传入 seed 可在之后重现完全相同的抽取结果（相同的种子、数量和类别始终返回相同的卡牌）；省略此参数则进行全新的随机抽取，并返回实际使用的种子。传入先前响应中的 session_id，可继续无重复会话（跨调用进行无放回抽取）。
• list_constraint_categories() — 列出九个类别，以及每个类别的卡牌数量和一个示例标题。
• get_constraint(id) — 根据 id 获取一张指定卡牌（例如 "inversion_03"）。

身份验证

无需密钥。无上游 API，也无第三方依赖。

数据源

• Pipeworx — 原创创意约束卡牌组。每张卡牌的标题、约束句和理由均为此卡牌组专门撰写；其内容并非基于公有领域或商业作品（不同于 tarot 的 Rider–Waite–Smith 传统或 i-ching 的 Legge 译本）。

九个类别

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 跨整个目录进行路由——无需再添加第二个 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