关于 tollbooth-authority-northamerica
tollbooth-authority-northamerica 是 DPYC Prime Authority 下、面向北美运营方的区域认证服务。它采用共享的 Authority 实现,并设有 New England 子级 Authority。
主要功能
- 01区域运营方认证
- 02DPYC Prime 作为上级 Authority
- 03支持 New England 子级 Authority
- 04共享 tollbooth-dpyc Authority 工具
- 05使用俄勒冈区域的 Neon 租户
适用场景
- 01认证服务北美用户的运营方
- 02使用区域 Authority 进行认证
- 03在区域 Neon 租户中保存认证记录
MCP 相关
通过 FastMCP 服务向 MCP 客户端提供共享的 Tollbooth Authority 工具。服务使用 tollbooth-dpyc 的通用 Authority 扩展。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://tollbooth-authority-northamerica.fastmcp.app/mcpclaude mcp add --transport http lonniev-tollbooth-authority-northamerica https://tollbooth-authority-northamerica.fastmcp.app/mcp{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}在 Cursor 中打开{"servers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"type":"http","url":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}{"mcpServers":{"lonniev-tollbooth-authority-northamerica":{"serverUrl":"https://tollbooth-authority-northamerica.fastmcp.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
70| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| npub | string | 是 | 要查询余额的 Nostr 公钥(npub1...)。 |
| dpop_token | string | 是 | 证明调用方持有 npub 的凭据:来自 receive_npub_proof 的授权信封,或由 npub 签名的 kind-27235 Nostr 事件原始 JSON,其中 `u` 标签的值为此工具的名称。 |
详细介绍
Tollbooth Authority — 北美
通往 Lightning 收费公路的北美入口匝道。
身份:
npub1zummm5awn88kw2hz6deeyjprpw0fzuv9rvzrxf3vu453yyqzvdss49xd2t上级:DPYC Prime Authority(npub1l94pd…mq8pf) Prime 旗下的对等 Authority:tollbooth-authority(Lonnie-Authority) 下级 Authority:tollbooth-authority-newengland服务:https://tollbooth-authority-northamerica.fastmcp.app/mcpNeon 区域:aws-us-west-2(俄勒冈州)
这是 DPYC Prime 旗下的同级 Authority,为北美运营方提供服务。运营方可以选择此 Authority,以便将认证延迟和审计轨迹保留在本区域。
本项目中的隐喻,致敬 Norton Juster 创作、Jules Feiffer 插画的《The Phantom Tollbooth》(1961)。我们只是搭建了支付基础设施。
架构
本仓库是对 tollbooth-dpyc wheel 中 tollbooth.authority 扩展(wheel ≥ 0.22.1)的轻量封装。整个可部署部分都位于 src/tollbooth_authority/server.py(约 90 行):一个 FastMCP 实例、一个 OperatorRuntime,以及两个 register_*_tools(mcp, runtime) 调用。入驻状态机、Schnorr 签名器、重放追踪器、Neon 租户配置,以及 16 个 Authority @tool 定义均驻留在 wheel 中,并由生态系统内的其他所有 Authority MCP 共享。
有关协议语义、证书格式(Schnorr/NIP-33 kind 30079)、费用级联、注册表强制执行以及工具目录,请参阅规范的 tollbooth-authority README——本仓库的行为完全相同,仅身份、区域和 Neon 租户不同。
部署
Horizon 需要两个密钥:
| 环境变量 | 值 |
|---|---|
TOLLBOOTH_NOSTR_OPERATOR_NSEC | 此 Authority 的 nsec |
NEON_DATABASE_URL | aws-us-west-2 中的 Neon 连接池连接字符串 |
其余内容——收银员的 BTCPay 凭据、运营方凭据模板——将在部署后通过 Secure Courier 提供(参阅社区仓库中的 docs/how-to-add-authority.md)。
DPYC 生态系统
DPYC 是由独立的、基于 SSE 的 MCP 服务组成的联盟,共享一个由 Lightning 资助的经济体系。本 Authority 为网络中的运营方提供认证。相关仓库:
核心与治理
tollbooth-dpyc— 共享的 Python SDK(加密、金库、身份验证、定价、审计)dpyc-community— 治理注册表(成员、规则手册、CI 验证)dpyc-oracle— 免费的社区顾问服务(会员资格、入门指导、税率问题)tollbooth-authority— 规范的认证 Authoritytollbooth-sample— 运营方参考实现tollbooth-pricing-studio— 原生定价编辑器(Swift/iOS)
运营方(付费 MCP 服务)
cypher-mcp— 通过 Neo4j/AuraDB 上命名的 Cypher 模板提供付费图谱问答(由本 Authority 认证)schwab-mcp— Charles Schwab 经纪业务数据thebrain-mcp— TheBrain 知识图谱访问excalibur-mcp— X/Twitter 发帖taxsort-mcp— 税务分类 + Cloudflare Pages UIoptionality-mcp— 期权分析
实用工具与倡导者
tollbooth-oauth2-collector— 共享的 OAuth2 回调收集器tollbooth-shortlinks— URL 缩短器
许可证
Apache-2.0
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。