halowerk-mcp

halowerk-mcp

70 个付费 API，可作为 MCP 工具使用。无需账户、无需登录、无需订阅——一个只装了几美元的临时钱包就够了。

签署任何内容之前，支出上限就已设定：

变量	默认值	作用
HALOWERK_MAX_PREIS_USDC	0.05	单次调用上限。费用更高的服务会被拒绝，不会悄悄购买。
HALOWERK_BUDGET_USDC	1.00	单个会话的上限。达到上限后，服务端会拒绝后续调用。
HALOWERK_TROCKEN	off	模拟运行：返回价格和调用计划，不会付款。

每个付费回答都会包含 bezahlt_usdc、budget_rest_usdc 和交易哈希，因此模型和你看到的数字相同。

---

无需钱包即可试用

有两个工具无需钱包且完全免费：halowerk_katalog 会列出所有服务及其价格，halowerk_preis 会告知计划调用的费用。安装后先浏览，之后再决定。

{
  "mcpServers": {
    "halowerk": { "command": "npx", "args": ["-y", "halowerk-mcp"] }
  }
}

将其放入 Claude Desktop 配置（claude_desktop_config.json）、Cursor 的 mcp.json 或 Cline 的 MCP 设置中。

为调用付款

{
  "mcpServers": {
    "halowerk": {
      "command": "npx",
      "args": ["-y", "halowerk-mcp"],
      "env": {
        "HALOWERK_PRIVATE_KEY": "0x…",
        "HALOWERK_MAX_PREIS_USDC": "0.05",
        "HALOWERK_BUDGET_USDC": "1.00"
      }
    }
  }
}

付款使用 x402，通过 Base 上的 USDC 完成。无需创建账户、无需银行卡、无需发票：调用会附带一份针对确切金额的签名授权，由服务完成结算。

使用临时钱包

创建一个新钱包，存入几美元的 USDC，不作其他用途。

这不是因为这个软件包不可信——而是因为你还没有理由信任它。MCP 配置中的密钥，是模型驱动的进程可以访问的密钥。要确保安全，方法不是信任代码，而是缩小潜在影响范围：如果钱包里只有三美元，最坏的情况也就是损失三美元。

你不需要 ETH 支付 Gas。付款使用 EIP-3009 transferWithAuthorization，因此交易由第三方提交。余额恰好为 0 ETH 是正常且正确的。

代码如何处理你的密钥

• 密钥只会从 HALOWERK_PRIVATE_KEY 读取，不会从其他地方读取——不读取文件、参数或提示词。
• 密钥绝不会写入日志、放入错误消息、在回答中返回，也不会被截断。对此有一项测试：npm run pruefe 会在全部输出中搜索密钥的前八个字符，若找到则测试失败。
• src/x402.ts 约 300 行，是唯一会接触密钥的文件。你可以在五分钟内读完。

你的钱可能流向哪里

服务端只会向构建时写入目录的十个主机付款。 列表在软件包中固定，不能通过文件、环境变量或工具参数扩展。

这是整个设计的核心。接受任意 URL 并为其付款的工具，相当于一条收款方字段留空的付款指令。模型读取网页、PDF 或电子邮件时，可能会被其中的文本诱导，使用攻击者的地址调用此类工具。因此：

• 目标主机必须与内置列表完全匹配。不能只比较后缀——halowerk.com.attacker.example 能通过任何 endsWith 检查，但它是另一个主机。
• 仅限 https。不会跟随重定向：重定向到外部主机的 301 是攻击，不是小麻烦。
• 不允许 IP 地址、localhost 或私有网段。
• 违反规则时：会说明原因并拒绝，且拒绝发生在签署任何内容之前。

halowerk_rufe_auf 接受的是目录中的工具名称，绝不接受 URL。

模式

一次启用 70 个工具会让所有人的工具选择器变得更难用，尤其是在你还连接了其他 MCP 服务时。因此：

HALOWERK_MODUS	工具	适用场景
hero（默认）	12 个服务 + 2 个免费工具	日常使用
gateway	3 个元工具 + 2 个免费工具	尽量减少上下文；需要多两次往返
all	70 个服务 + 2 个免费工具	你清楚自己需要什么

在 gateway 模式下：halowerk_suche 按描述查找服务，halowerk_beschreibe 返回其输入架构，halowerk_rufe_auf 执行该服务。

为什么是这十二个

只有一项衡量标准：在同一任务中，Agent 需要重复使用什么？ 每个会话只用一次的工具可以随时查找；用十次的工具才值得放进工具箱。这十二个工具也都是文本输入、文本输出——在聊天窗口中，必须先上传文件才能使用的工具几乎无法使用。

工具	重复使用的原因
cost_estimate	每次调用模型前
output_validate	每次模型回答后
tool_arg_validate	每次成本高昂或不可逆的调用前
state_store	长任务的每个步骤都会用到
cve_check	每份依赖项列表都要检查，而且会多次查看
license_check	同一项审计，每组软件包都要检查
tls_chain	基础设施检查中的每台主机
jwt_verify	调试身份验证时的每个令牌
webhook_signature	调试集成时的每个 Webhook
doc_diff	审查中的每对文件
web_archive	研究任务中的每个 URL
invoice_audit	批次中的每张发票

分档计价——设置预算前请先阅读

有些服务按单位计费：每分钟音频、每 1000 个字符或每个采样点。对于这些服务，price_usdc 只是最低价。

因此，预算检查使用上限 max_usdc。如果按最低价检查，就会批准 0.006，却要支付 0.25——该端点按长度计费，而长度信息在请求正文中，不在目录里。

如果服务完全没有上限，就视为无上限；除非设置了 unbegrenzt_erlauben: true，否则不会调用该服务。按未知金额检查的预算不算预算。

本软件包不是什么

• 它不是钱包管理器。它会签署付款，但绝不会将资金转移到其他地方。
• 它不会创建或存储密钥。
• 它不会向外部发送数据。所有出站请求都只发往目录中的十个主机。
• 目录由实时服务生成，并随软件包一起发布。运行时不会获取目录，因此即使服务器遭到入侵，也无法在两次调用之间将其加入你的允许列表。

开发

npm run katalog   # regenerate katalog.json from the live services
npm run build     # compile TypeScript
npm run pruefe    # modes, spending brakes, attack tests, key-leak test

katalog.json 是生成的。切勿手动编辑——请重新生成并重新发布，否则软件包承诺的价格就会与服务实际收取的价格不符。

许可证

MIT。请参阅 LICENSE。