蒂巴因mcp v1.10.0
闪电收费公路上的第一座城市。
  
一个MCP服务器，允许AI代理对个人知识图进行读写访问，并通过比特币闪电微支付为自己付费。
*这个项目中的隐喻来自* 幻象天堂 *诺顿·贾斯特，朱尔斯·费弗（1961）插图。Milo、Tock、Tollboot、Dictionopolis和Digitopolis是Juster先生非凡想象力的创造。我们刚刚建立了支付基础设施。*
______________________________________________________________________
第一座城市
每个收费公路都需要它的第一个城市。在售票亭可以收取车费，当局可以签发采购订单之前，必须有人建造一个值得开车去的目的地。
这也是 收费亭DPYC™ --第一个MCP服务器，每个工具调用都通过比特币闪电微支付进行计量。预融资、使用、充值。没有订阅，没有与账单账户绑定的API密钥，没有法定支付处理器。新颖的贡献：MCP服务器架构，运营商通过闪电微支付将AI代理访问货币化，而无需在对话中打扰客户端。
入门指南
通过地平线MCP连接
将任何兼容MCP的客户端（Claude Desktop、Cursor、您自己的代理）连接到实时端点：
https://personal-brain.fastmcp.app/mcp无需配置——Horizon OAuth会自动处理身份验证。
首次连接演练
session_status--检查您当前的会话状态。- 得到你的 赞助人npub 来自dpyc oracle
how_to_join()工具——这是您注册为DPYC™Citizen的npub，您的信用操作身份。 - 安全快递入职：
- 呼叫 request_credential_channel(recipient_npub= ) --打开安全快递通道；向您的Nostr客户发送欢迎DM。 - 使用JSON格式的凭据通过Nostr客户端回复： {"api_key": "...", "brain_id": "..."} - 呼叫 receive_credentials(sender_npub= ) --保管您的凭据并激活会话。种子余额会自动授予。
list_knowledge_bases→set_active_knowledge_base--选择要使用的大脑。query_knowledge_base--开始探索你的知识图谱。
返回用户： 呼叫 receive_credentials(sender_npub= ) --vault首次查找会立即激活，不需要中继I/O。
安全快递
凭证通过加密的Nostr DM传递——它们永远不会出现在聊天窗口中。在首次中继接收时，服务会发送 ncred1... 凭证卡通过DM返回给用户，以便扫描和粘贴重复使用。
循环中的人： 赞助人必须有意识地通过其Nostr客户批准每次凭证交付。从不自动轮询或自动重试 receive_* 呼叫-每个 receive_credentials 破坏性地耗尽继电器（拾取后删除NIP-09）。每次凭证交付时只调用一次。
学分模型
| 类别 | 定价提示 | 示例 |
|---|---|---|
free | 0个座位 | session_status, check_balance, check_price |
read | 1个座位 | get_knowledge_node, search_knowledge_nodes, get_note |
write | 5个座位 | create_knowledge_node, create_link, update_knowledge_node |
heavy | 10个座位 | query_knowledge_base, get_modifications |
实际价格由Neon中的运营商定价模型通过以下方式动态设置 api_sats 每个工具。身份验证和平衡工具始终是免费的。首次用户在入职时会收到种子余额，足以在不预先购买积分的情况下进行探索。
信用证以分期付款的形式发放 tranche_lifetime （TTL）。批次按先进先出原则消耗；过期的部分会自动修剪。使用 check_balance 查看您的余额、活动部分和使用历史。通过充值 purchase_credits 比特币闪电。
安全
- 身份是嗅觉的关键 --用户由
npub（Nostr公钥），而不是电子邮件或用户名。这nsec（私钥）保留在用户手中——从不共享，从不发送到服务。 - 证明是善良的-27235 Schnorr签名的NIP-98活动 --每个付费工具都需要
proof参数。证明是由用户的nsec签名的JSON序列化Nostr事件，将他们的npub绑定到特定的工具调用。 - 人在回路 --赞助人必须通过他们的诺斯特客户签署每份证明。代理永远不会自动生成或缓存证明。证明缓存（自v0.9.2起支持vault）存储经过验证的证明约1小时；续订需要新的请求/接收周期。
- 通过Secure Courier获取凭据 -brain API密钥和大脑ID通过NIP-44加密的Nostr-DM传递，存储在Neon Postgres中，从不在聊天窗口中暴露。
BrainQuery（BQL）
专为TheBrain构建的Cypher子集查询语言。代理和人类以相同的形式表示图操作——通过 MATCH, CREATE, SET, MERGE，以及 DELETE.
MATCH (n {name: "Projects"})-[:CHILD]->(m) RETURN m
MATCH (n) WHERE n.name =~ "quarterly review" RETURN n
MATCH (p {name: "Ideas"}) CREATE (p)-[:CHILD]->(n {name: "New Concept"})
MATCH (root {name: "Company"})-[:CHILD*1..3]->(d) WHERE d.name CONTAINS "Budget" RETURN d可变长度路径、多跳链、复合 WHERE 和 AND/OR/NOT/XOR、相似性搜索和属性存在检查。完整语法 python/BRAINQUERY.md.
故障排除
当工具调用失败时， 阅读回复 -它告诉你发生了什么以及接下来要做什么。凭证生命周期状态不是错误；它们是有明确指导的预期情况。
| 情况 | 该怎么办 |
|---|---|
| 需要证明 | 呼叫 request_npub_proof 然后 receive_npub_proof --新的请求/接收周期。缓存将在约1小时后过期。 |
| 信用余额不足 | 呼叫 purchase_credits 充值。 |
| 冷启动/会话未就绪 | 10-15秒后重试。v0.13.5+中提供了内联重试功能。 |
| 未找到凭据 | 遵循Secure Courier入职流程（上述步骤3）。 |
| 上游API错误 | 只有当错误明确提到TheBrain API失败时。不是凭证或账单问题。 |
不要骚扰你的客户： 除非错误消息明确指出凭据丢失或过期，否则不要要求用户重新验证或重新执行快递流程。
自我寄宿
有关本地安装、配置和完整的工具参考，请参阅 python/README.md.
要运行自己的实例，请设置以下环境变量：
必需
| 变量 | 目的 |
|---|---|
TOLLBOOTH_NOSTR_OPERATOR_NSEC | 操作员的Nostr密钥——用于身份、安全信使DM和审计签名的单个引导密钥 |
这是启动所需的唯一环境变量。认证运营商通过加密的Nostr DM从管理局引导他们的霓虹数据库URL-- NEON_DATABASE_URL 不会从环境中读取。
可选调整
| 变量 | 目的 |
|---|---|
TOLLBOOTH_NOSTR_RELAYS | 逗号分隔的中继URL（覆盖默认值） |
THEBRAIN_API_URL | TheBrain API基础URL（默认值： https://api.bra.in) |
SEED_BALANCE_SATS | 新用户的免费启动余额（0表示禁用） |
CREDIT_TTL_SECONDS | 批次生命周期（秒）（默认值：604800=7天） |
DPYC_REGISTRY_CACHE_TTL_SECONDS | 缓存DPYC社区注册表的时间（默认值：300） |
CONSTRAINTS_ENABLED | "true" 在工具调用上启用约束引擎评估 |
通过安全信使（非env变量）获取凭据
所有秘密都通过Secure Courier传输——它们从不作为环境变量出现：
| 凭证 | 交付 |
|---|---|
| TheBrain API密钥+大脑ID | Patron通过加密Nostr DM交付 |
BTCPay凭证(btcpay_host, btcpay_api_key, btcpay_store_id) | 运营商通过安全快递交付 |
注： THEBRAIN_API_KEY 不是环境变量。顾客通过Secure Courier（加密Nostr DM）交付TheBrain API密钥和大脑ID。只有操作员的nsec配置为env var。演员协议
这 BrainOperator 类（in actor.py)满足 OperatorProtocol 从 dpyc收费站这是现有授权之上的一层薄薄的授权 server.py 工具功能。
from thebrain_mcp.actor import BrainOperator
from tollbooth import OperatorProtocol
assert isinstance(BrainOperator(), OperatorProtocol)演员揭露：
slug--退货"brain"用于工具名称前缀register_standard_tools()--将标准Tollbooth DPYC™工具（会话、计费、社区）委托给车轮tool_catalog()--退货OPERATOR_BASE_CATALOG(19ToolPathInfo条目）--来自tollbooth dpyc的标准工具表面
| 路径 | 工具 | 状态 |
|---|---|---|
| 热门（本地分类账） | check_balance, account_statement, account_statement_infographic, restore_credits, service_status | 已实现--委托给server.py |
| 热门（安全快递） | session_status, request_credential_channel, receive_credentials, forget_credentials | 已实施——使用凭证卡DM传递往来凭证 |
| 授权（权限） | purchase_credits, check_payment | 已实施——通过MCP向MCP进行自动认证 |
| 授权（权限） | certify_credits, register_operator, operator_status | Stub——直接连接到管理局MCP |
| 委派（Oracle） | lookup_member, how_to_join, get_tax_rate, about, network_advisory | 已实现——通过OracleClient从MCP到MCP |
支付处理通过权威机构（服务器到服务器OAuth）自动认证。Secure Courier通过带有自动凭证卡的Nostr DM提供加密凭证(ncred1...)DM在首次收到时返回。Oracle社区工具直接路由到DPYC™Oracle——免费且未经身份验证。
建筑
Tollboot DPYC™生态系统是一个跨越三个存储库的三方协议：
| 代表 | 角色 |
|---|---|
| 收费站管理局 | 机构——税收征收、Schnorr签署、采购订单认证 |
| dpyc收费站 | 展台——操作员侧信用账、BTCPay客户端、工具门控 |
| dpyc预言机 | 礼宾服务——社区入职、税率、会员查询 |
| 蒂巴因mcp （此回购） | 第一个由Tollbooth DPYC™提供支持的城市参考MCP服务器 |
项目结构
thebrain-mcp/
├── python/ # FastMCP server package
│ ├── src/thebrain_mcp/ # Server source, BQL engine, Tollbooth
│ ├── tests/ # Test suite (525+ tests)
│ ├── README.md # Install, config, tools, usage
│ └── BRAINQUERY.md # BQL grammar and reference
├── docs/
│ └── diagrams/ # Architecture and protocol flow diagrams
├── LICENSE # Apache License 2.0
└── NOTICE # Attribution notice先前技术与归属
此存储库中包含的方法、算法和实现可能代表Lonnie VanZandt于2026年2月16日首次发表的原创作品。根据美国专利法（35 U.S.C.102），本公开披露确立了现有技术。
所有使用、复制或衍生作品必须符合本存储库中包含的Apache许可证2.0，并且必须按照 通知 文件。
如何归因
如果您使用或构建此作品，请在您的文档或来源中包含以下内容：
Based on original work by Lonnie VanZandt and Claude.ai
Originally published: February 16, 2026
Source: https://github.com/lonniev/thebrain-mcp
Licensed under Apache License 2.0访问比特币倡导者和咖啡爱好者的技术专家虚拟咖啡馆 stablecoin.myshopify.com.
专利通告
作者保留为本文所述的新方法和系统寻求专利保护的所有权利。这项工作的公开披露确定了2026年2月16日的优先日期。根据《美国发明法》，作者自首次公开披露之日起保留一年的宽限期，以提交专利申请。
潜在申报人注意事项： 该公共存储库及其完整的Git历史可作为现有技术的证据。根据《美国法典》第35卷第102（a）条，在该存储库发布日期后提交的任何涉及基本相似方法的专利申请都可能无效。
DPYC™生态系统
- dpyc社区 --注册+治理
- dpyc收费站 --Tollboot DPYC™货币化的Python SDK
- 收费站管理局 --授权MCP服务
- excalibur mcp --推特MCP服务
- 施瓦布mcp --Schwab经纪MCP服务
- dpyc预言机 --社区礼宾服务
- 收费亭样品 --教育天气MCP（新操作员的标准参考）
进一步阅读
闪电收费公路上的幻影收费站 --我们如何将AI API货币化，然后逐渐淡出人们的视线。
商标
DPYC™、Tollbooth DPYC™和Don't Pester Your Customer™是Lonnie VanZandt的商标。请参阅 商标.md 在dpyc社区存储库中获取使用指南。
许可证
Apache许可证2.0——请参阅 许可证 和 通知 了解详情。
______________________________________________________________________
*因为最终，收费站从来都不是目的地。这总是旅程的开始。*