Pebbler Human Feedback

Pebbler MCP

让你的 Agent 收集人们对两张图片的反馈，并解释结果。Pebbler 会通过 Pebbler app 让参与者进行图片偏好测试。

创建测试前，你的 Agent 会获取当前定价、套餐详情和可用情况。购买时会使用实时报价，并遵守你配置的支出限额。此连接器不会固定定价和套餐规格。

版本 1 支持图片 A/B 偏好测试。这类测试用于衡量人们更喜欢哪张图片，而非产品转化或因果效应。无法保证收到的回复数量。不支持问卷调查和纯文本比较。

连接你的 Agent

使用支持本地服务和 Node.js 22 或更高版本的 MCP 应用。将以下配置添加到你的应用中：

{
    "mcpServers": {
        "pebbler": {
            "command": "npx",
            "args": ["-y", "@pebbler/[email protected]"]
        }
    }
}

其中已包含 Pebbler 的生产环境设置。你可以查看当前套餐并创建草稿，无需启用付款。

启用购买

使用一个专用钱包，并为其存入 Base 上的原生 USDC。在 MCP 应用的本地环境或密钥设置中配置以下设置：

设置	需要提供的内容
PEBBLER_ALLOW_PAYMENTS	需要 Agent 进行购买时，设为 true
PEBBLER_WALLET_PRIVATE_KEY	钱包的签名密钥，请私下提供
PEBBLER_MAX_PURCHASE_USDC	你为每次测试设定的最高支出额，必须是正数形式的 USDC 金额
PEBBLER_MAX_TOTAL_USDC	你设定的累计支出限额，必须是正数形式的 USDC 金额

启用付款时，必须设置两个支出限额。它们代表你的预算，而不是测试价格。如果报价超过任一限额，连接器会停止操作，而不会提高你的预算。除非你明确启用，否则付款将保持禁用状态。

钱包密钥会保留在本地。不要将其放入提示词或在对话中分享。价格和报价由 Agent 获取；你无需配置这些内容。

请求测试

例如：

查看当前套餐和价格，然后比较以下两个图片 URL。购买前告诉我报价，并遵守我配置的预算。

提供两个可公开访问的 HTTPS 图片 URL 和一个明确的问题。请使用你拥有或获准使用的图片，并确保在收集回复期间这些 URL 始终可用。

你的 Agent 可以展示当前优惠、创建草稿、购买测试并查看进度。收集仍在进行时，你可以查看部分结果，也可以稍后再询问最终票数和投票占比。获取结果已包含在购买中。

可用工具

工具	用途
get_catalog	获取当前套餐、价格、支持的输入和可用情况
create_study	准备图片比较并获取报价
quote_study	签署付款前刷新报价
purchase_study	在钱包支出限额内购买报价对应的测试
get_study_status	查看进度以及何时再次检查
get_study_results	获取汇总的 A/B 投票数和占比
list_local_studies	返回或重启后查找已保存的测试

连接后，Agent 会自动了解各工具的输入。它应先读取目录，再根据报价进行购买，并在检查进度时遵循返回的轮询间隔。

返回结果

请备份连接器的私有本地状态文件夹。该文件夹会在重启后保留对测试及其购买历史的访问权限。你可以通过 PEBBLER_STATE_DIR 选择文件夹；返回现有测试时，请使用同一个文件夹。

你的总支出限额会计入已保留的签名购买，包括尚未解决的尝试，且不会自动重置。如果想购买更多测试，请谨慎提高限额。请保留原始状态，不要通过删除它来重置预算。

如果购买中断或处于待处理状态，请让 Agent 重试同一笔购买。连接器会保留其标识符和付款授权，而不会再次签署付款。读取进度和结果无需再次购买。

尝试示例

随附的 examples/run-study.mjs 演示了如何发现并创建图像对比。它会打印实时目录和报价；购买需要使用 --purchase 标志，以及你在本地配置的钱包和预算。

许可证

MIT。原始示例图片素材采用相同许可证。