关于 databroker
databroker 是面向 Agent 的 MCP 服务,提供英国车辆 MOT 数据、可靠性分析和标识符实用工具。它通过 Base 上的 USDC 按次收费,并采用先报价再确认的流程和可配置的单次支出上限。
主要功能
- 01发现可用数据集和价格
- 02获取单条数据点
- 03批量获取最多 100 个键
- 04查看数据时效和来源
- 05先报价并设置支出上限
适用场景
- 01查看英国车辆的 MOT 历史
- 02评估二手车里程是否可靠
- 03批量获取单个数据集中的多个键
- 04使用数据点前检查其时效
MCP 相关
向 MCP 客户端提供数据集发现、数据点获取、元数据、健康状态和批处理工具。付费获取须先报价再确认;支持 elicitation 的客户端还可请求用户直接审批。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @mossforge/databroker-mcpDATABROKER_BASE_URLBase URL of the DataBroker API, e.g. https://api.databroker.mossforge.devDATABROKER_SIGNERSigner provider: "raw" (default, self-custodied private key) or "cdp" (Coinbase CDP-managed wallet)DATABROKER_WALLET_KEY密钥0x-prefixed private key for the paying wallet. Required when DATABROKER_SIGNER=raw (the default).CDP_API_KEY_ID密钥Coinbase CDP API key id. Required when DATABROKER_SIGNER=cdp.CDP_API_KEY_SECRET密钥Coinbase CDP API key secret. Required when DATABROKER_SIGNER=cdp.CDP_WALLET_SECRET密钥Coinbase CDP wallet secret. Required when DATABROKER_SIGNER=cdp.DATABROKER_MAX_USDCPer-call spend cap in USDC. Calls priced above this are declined before payment.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
databroker-mcp-server
让任何支持 MCP 的 Agent(Claude Desktop、Claude Code、Cursor 等)都能按次付费访问 MossForge DataBroker——英国车辆 MOT 智能分析、覆盖全英国的可靠性分析,并通过 Base 主网上的 x402 USDC 微支付自动处理付款。无需 API 密钥,也无需订阅:为钱包充值,然后提问。
工具
| 工具 | 费用 | 用途 |
|---|---|---|
databroker_discover | 免费 | 列出已启用的数据集、其 kind 以及每次调用的 USDC 价格 |
databroker_fetch | 报价免费,确认后付费 | 获取某个数据集和键对应的单个数据点 |
databroker_meta | 免费 | 查看数据点的陈旧度、TTL 和来源信息,无需付费 |
databroker_health | 免费 | 检查 API 运行状态 |
databroker_batch_create | 报价免费,确认后付费 | 在单个任务中从一个按需数据集获取最多 100 个键,仅需支付一次费用 |
databroker_batch_status | 免费 | 查询由 databroker_batch_create 创建的批处理任务 |
付款绝不会自动进行。 databroker_fetch 和 databroker_batch_create 总会先报价——只有再次调用工具并设置 confirm: true 后才会付款。每次付费调用也都受 DATABROKER_MAX_USDC 限制(默认为 0.50);超过上限的调用会在付款前被拒绝。
对于支持 elicitation 的客户端,付款审批由服务端强制执行,而非由调用模型决定。 每次付款前,此服务都会通过已连接的客户端发送 MCP elicitation 请求,直接询问用户是否批准或拒绝确切的费用——不受模型传入的 confirm 值影响。Claude Code(CLI)从 v2.1.76 起支持此功能;其他客户端(Claude Desktop、Cursor 等)可能尚不支持。
如果已连接的客户端未声明支持 elicitation,服务端会回退到 elicitation 之前的保障机制——要求调用模型传入 confirm: true,并继续受 DATABROKER_MAX_USDC 限制——而不是阻止所有付费调用。如果确定客户端支持 elicitation,并希望采用更严格的保障机制,可设置 DATABROKER_REQUIRE_ELICITATION=true,以阻止不支持 elicitation 的客户端发起付费调用。服务端会在启动时以及不支持 elicitation 的客户端首次连接时记录当前启用的模式。
设置
-
创建一个新的 EOA 钱包,并在 Base 主网上为其充值几 USDC(不要充值其他资产——无需 ETH;EIP-3009 转账对付款方免 Gas)。
-
添加到 Claude Desktop(
claude_desktop_config.json):
{
"mcpServers": {
"databroker": {
"command": "npx",
"args": ["-y", "@mossforge/databroker-mcp"],
"env": {
"DATABROKER_BASE_URL": "https://api.databroker.mossforge.dev",
"DATABROKER_WALLET_KEY": "0x...",
"DATABROKER_MAX_USDC": "0.50"
}
}
}
}
claude mcp add --transport stdio \
--env DATABROKER_BASE_URL=https://api.databroker.mossforge.dev \
--env DATABROKER_WALLET_KEY=0x... \
databroker -- npx -y @mossforge/databroker-mcp
- 提问:“我应该买这辆 2018 年款的 Golf 吗?车牌号是 AB18 CDE。查一下它的 MOT 历史,以及里程数是否看起来真实。”
谁持有钱包
支持两种签名提供方,通过 DATABROKER_SIGNER 设置:
raw(默认)——你持有私钥,并从DATABROKER_WALLET_KEY读取。除了为钱包充值外无需其他设置,但密钥材料的安全性取决于此进程运行环境的安全性,且支出上限仅由此代码库强制执行。cdp——从 Coinbase CDP 管理的钱包付款。私钥不会接触此进程;CDP 会在远程签名,并可在托管层强制执行支出策略(会话上限、允许的代币)。需要 CDP 账户、CDP_API_KEY_ID/CDP_API_KEY_SECRET/CDP_WALLET_SECRET,以及npm install @coinbase/cdp-sdk(这是可选依赖,默认不会安装)。
安全说明
- 使用专用的低余额钱包。在
raw模式下,密钥不会离开你的设备;付款通过@x402/*v2 协议栈(@x402/fetch+@x402/core/client+@x402/evm/exact/client)在本地签名,并生成 EIP-3009transferWithAuthorization载荷。 - 单次调用上限(
DATABROKER_MAX_USDC)决定了任何单次调用可能造成的损失范围,并且会在发送任何付款前进行检查——高于上限的调用会被拒绝,不会扣款。除此之外,总风险敞口取决于钱包余额,因此请保持余额较低。 - 每次付费调用都会先获取报价:除非再次调用并设置
confirm: true,否则databroker_fetch和databroker_batch_create都不会花钱。 - 此外,当已连接的客户端声明支持 MCP elicitation 时,每笔付款还必须由人工明确接受服务器本身发送的提示词,其中会注明确切的 URL 和 USDC 金额——这一要求由代码强制执行(
lib.ts中的confirmWithHuman),而非交由调用模型自行判断。不支持 elicitation 的客户端会跳过这项额外检查(如果你希望在这种情况下默认拒绝,请参阅下文的DATABROKER_REQUIRE_ELICITATION)。
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
DATABROKER_BASE_URL | 是 | — | 例如:https://api.databroker.mossforge.dev |
DATABROKER_SIGNER | 否 | raw | raw 或 cdp——参阅谁持有钱包 |
DATABROKER_WALLET_KEY | 是,如果 SIGNER=raw | — | 以 0x 为前缀的私钥 |
CDP_API_KEY_ID | 是,如果 SIGNER=cdp | — | Coinbase CDP API 密钥 ID |
CDP_API_KEY_SECRET | 是,如果 SIGNER=cdp | — | Coinbase CDP API 密钥 Secret |
CDP_WALLET_SECRET | 是,如果 SIGNER=cdp | — | Coinbase CDP 钱包 Secret |
DATABROKER_MAX_USDC | 否 | 0.50 | 单次调用支出上限,无论签名者是谁都会强制执行 |
DATABROKER_REQUIRE_ELICITATION | 否 | false | 如果为 true,则在不声明支持 MCP elicitation 的客户端上阻止付费调用,而不是仅依赖 confirm: true 进行确认 |
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。