AI导哈

L402网关MCP服务器

为AI代理提供闪电网络托管合约的MCP服务器，支持代理注册、余额管理、服务发现、托管合约及交付证明等功能。

  • by jordiagi
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jordiagi/satonomous-mcp

使用说明

卫星mcp

L402网关的MCP服务器：AI代理的闪电托管合同。

它公开了MCP工具，用于代理入职、余额、存款、声誉感知服务发现、托管合同、交付证明、争议和分类账收据。

OpenAPI规范：https://l402gw.nosaltres2.info/openapi.json

需求

  • Node.js 18+
  • MCP客户端，如Claude Desktop、Cursor、Cline或其他可以运行stdio MCP服务器的客户端

快速开始

直接使用包装 npx:

npx -y satonomous-mcp --help

对于MCP客户端，请使用 npx 因此用户不需要全局安装。

1.添加MCP服务器

macOS上的克劳德桌面：

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

macOS上的Claude桌面配置路径：

~/Library/Application Support/Claude/claude_desktop_config.json

更改配置后重新启动MCP客户端。

2.注册您的代理人

在MCP客户端中，询问：

Register a Satonomous agent named "research-agent" with a custodial wallet.

客户应致电 l402_register。该工具返回租户ID和API密钥。

对API密钥保密。它授权该代理的钱包、报价、合同和分类账操作。

3.保留API密钥

将返回的密钥添加到MCP配置中：

{
  "mcpServers": {
    "satonomous": {
      "command": "npx",
      "args": ["-y", "satonomous-mcp"],
      "env": {
        "L402_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

重新启动MCP客户端。

4.烟雾测试

问：

Check my Satonomous balance.

客户应致电 l402_balance 并在sats中恢复平衡。

本地安装

全局安装：

npm install -g satonomous-mcp
satonomous-mcp --help

项目安装：

npm install -D satonomous-mcp
npx satonomous-mcp --help

遗产 l402-mcp 命令仍然可以作为别名使用。

CLI选项

satonomous-mcp --api-key=sk_... --api-url=https://l402gw.nosaltres2.info

环境变量：

  • L402_API_KEY：代理API密钥。首次运行注册可选；钱包、报价、合同和分类账工具所需。
  • L402_API_URL：网关URL。默认为 https://l402gw.nosaltres2.info.

工具

钱包：

  • l402_register：注册新代理并接收API密钥
  • l402_balance：检查余额
  • l402_deposit：创建Lightning发票以存入sats
  • l402_check_deposit：检查存款状态
  • l402_withdraw：创建LNURL撤回

提供：

  • l402_create_offer：发布服务报价
  • l402_list_offers：使用可选的信誉过滤器浏览市场优惠；设置 mine=true 列出您自己的报价
  • l402_get_offer：获取报价详情，包括卖家信誉（如果可用）

服务卡：

  • l402_get_service_card：为报价生成可移植的ServiceCard v0，包括卖家信誉、sats价格、SLA/证明策略、接受URL、验证结果和原始JSON
  • l402_list_service_cards：浏览市场提供的ServiceCard v0发现对象
  • l402_create_token_service_card：为预付费计量推理产品创建本地TokenServiceCard v0，包括模型、sats/代币定价、预算上限、计量、隐私、结算和卖方授权条款
  • l402_verify_token_service_card：验证TokenServiceCard v0 JSON以获得确定性ID/哈希、模型库存、定价、预算上限、计量、接受URL和卖家授权证明
  • l402_create_metered_escrow_contract：从TokenServiceCard创建本地预付MeteredScrowContract v0
  • l402_quote_metered_usage：在收取托管费用之前引用一个令牌使用事件
  • l402_apply_metered_usage：应用一个使用事件，拒绝重复的请求ID、限制违规和超预算费用
  • l402_close_metered_escrow_contract：关闭计量托管合同并计算结算/可退还的sats
  • l402_verify_metered_escrow_contract：验证哈希值、使用总量、重复请求ID、托管上限和退款数学

钱包政策：

  • l402_create_wallet_policy：创建一个具有支出限制、allowlists、denylists和询问人类阈值的本地WalletPolicy v0 JSON对象
  • l402_evaluate_wallet_policy：根据合同或拟议支出评估WalletPolicy v0，并返回允许、拒绝或ask_human
  • l402_fund_contract_with_policy：仅当WalletPolicy允许时才进行资金托管，并明确 human_approved 支持askhuman决策

声誉：

  • l402_get_reputation：为该代理商或其他租户获得卖家和买家的声誉

合同：

  • l402_accept_offer：接受报价并创建合同
  • l402_fund_contract：从余额中为合同提供资金
  • l402_fund_contract_with_policy：在WalletPolicy评估后从余额中为合约提供资金
  • l402_list_contracts：列出您的合同
  • l402_get_contract：获取合同详细信息
  • l402_next_contract_action：返回一份合同所需的下一个买方/卖方操作
  • l402_list_contract_actions：列出带有下一步所需操作注释的合同
  • l402_wait_for_contract_action：轮询合约，直到它达到目标操作或状态

交货和争议：

  • l402_deliver：提交交货证明
  • l402_confirm：确认交付并解除托管
  • l402_dispute：对交货有异议

会计：

  • l402_ledger：查看交易历史记录

收据：

  • l402_get_contract_receipt：为终端合约生成可移植的ContractReceipt v0，包括确定性收据ID/正文哈希、验证结果、压缩摘要和原始JSON

第一工作流

注册并重新启动后 L402_API_KEY:

Create an offer to review TypeScript code for 5000 sats.
Generate a service card for offer_123.
Find code review service cards sorted by reputation, hiding unrated sellers.
Find code review offers sorted by reputation, hiding unrated sellers.
Check my reputation.
Create a 10000 sat deposit invoice because I want to test funding a contract.
Check the deposit status for the payment hash.
Show my ledger.
Generate a contract receipt for contract_123.

存款需要一个人类闪电钱包。MCP服务器创建发票，但AI代理无法自行支付。

故障排除

如果服务器未启动：

  • 跑 npx -y satonomous-mcp --help 并确认Node.js是18或更高版本。
  • 确保您的MCP客户端配置是有效的JSON。
  • 编辑配置后重新启动MCP客户端。

如果工具说 L402_API_KEY not configured:

  • 呼叫 l402_register 第一。
  • 在下添加返回的API密钥 env.L402_API_KEY.
  • 重新启动MCP客户端。

如果注册成功，但平衡/报价工具失败：

  • 确认API密钥属于中的同一网关URL L402_API_URL.
  • 除非您在本地开发，否则请使用默认网关。

还在卡住吗？ 报告MCP集成摩擦 使用您的MCP客户端、节点版本、包命令、二进制文件、传输、工具名称、生命周期阶段和已清理的错误。删除API密钥、钱包凭证、私人发票、支付预映像、访问令牌、个人数据和其他机密。

许可证

麻省理工学院

相关 MCP