three.ws Knock

@three-ws/knock-mcp

让 Agent 联系到真人。

Knock 是一扇有价的通往真人的门。每个 three.ws 账户 都可以在 three.ws/knock/<handle> 发布一扇门，所有者可设置陌生人发送一条 消息的价格。支付该价格，即可让一条消息送达：消息会进入对方的收件箱；无论对方在网站的哪个位置，其 3D 伴侣都会走到屏幕上，并大声报出消息，同时说出发送者的名字 和支付金额。USDC 会直接结算给接收者。

这个 MCP 服务为任何 Agent 客户端（Claude Code、Claude Desktop、Cursor、 Windsurf 或你自己的客户端）提供工具，用于查找可以联系的人、敲门并查看回复。

此服务不持有钱包

对于免费的门，knock_send 会立即发送，因为没有资金流动。

对于收费的门，knock_send 不会付款，也无法付款。它会返回 接收者、金额、代币、链和端点，然后停止。由真人批准支出，并使用自己掌控的钱包付款，可通过 @three-ws/knock 或其他 x402 客户端完成。

这是有意为之。带有环境变量密钥的 MCP 服务不应该能够自行转移他人的资金。

安装

Claude Code：

claude mcp add knock -- npx -y @three-ws/knock-mcp

任何 MCP 客户端均可通过配置使用：

{
	"mcpServers": {
		"knock": {
			"command": "npx",
			"args": ["-y", "@three-ws/knock-mcp"]
		}
	}
}

只有在还需要使用两个所有者侧工具时，才添加 THREE_WS_API_KEY：

{
	"mcpServers": {
		"knock": {
			"command": "npx",
			"args": ["-y", "@three-ws/knock-mcp"],
			"env": { "THREE_WS_API_KEY": "sk_live_…" }
		}
	}
}

Node 20+。

工具

工具	凭据	功能
knock_quote	无	查询某人发送单条消息的收费、接受付款的链、长度限制和端点。
knock_directory	无	按价格从低到高列出当前可联系的所有人。
knock_send	无	发送一条消息。免费门会直接发送；收费门会提供报价，供真人批准。
knock_receipt	无	查看已发送的敲门消息状态：待处理、已读、已回复（附回复内容）或已忽略。
knock_inbox	THREE_WS_API_KEY	查看你的门收到的敲门消息，包括发送者支付的金额，以及总计。
knock_act	THREE_WS_API_KEY	回复、标记为已读、忽略或屏蔽其中一条消息。

所有者工具在服务端按账户限定范围，绝不会读取或更改其他账户。

会话示例

你： 在 three.ws 上找一位愿意回答 x402 问题的人，问问他们的 Solana facilitator 如何处理 fee payer。

Agent 会调用 knock_directory，选择一扇门，再调用 knock_quote 获取 实时报价，然后返回：

nirholas (@nirholas) charges $0.05 USDC on solana.
Endpoint: https://three.ws/api/x402/knock?to=nirholas
The payment settles directly to the recipient.
Approve?

你从自己的钱包批准并付款：

npx @three-ws/knock send nirholas \
  "How does your Solana facilitator handle the fee payer?" \
  --from "Ada (research agent)" --subject "x402 fee payer" --payer ./payer.mjs

对方的伴侣会走到屏幕上并说道：“Ada 支付了 $0.05 联系你：x402 fee payer。” 对方回复后，Agent 会通过收据 URL 调用 knock_receipt， 并读出回复。双方都无需拥有门所有者账户以外的账户。

环境

变量	必需	默认值	用途
THREE_WS_API_KEY	仅 knock_inbox / knock_act 需要	无	你所管理门所属账户的 API 密钥或 OAuth 令牌。别名：THREE_WS_TOKEN、THREE_WS_BEARER。
THREE_WS_BASE	否	https://three.ws	仅在自托管时覆盖。
THREE_WS_TIMEOUT_MS	否	20000	每个请求的超时时间。

运行和检查

node src/index.js                     # stdio
npm run inspect                       # MCP Inspector
npm test                              # the tool surface and the no-wallet rule

相关内容

• @three-ws/knock 是实际负责付款的 SDK 和 CLI。
• three.ws/knock 可用于开启你自己的门。
• Knock 文档 介绍协议和线格式。

许可证

Apache-2.0