Solana加密货币邮件服务

一个基于Solana加密货币的物理邮件发送服务,允许AI代理通过Model Context Protocol服务器发送实体信件和明信片到全球各地。

  • by ExpertVagabond
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ExpertVagabond/solmail-mcp

使用说明

:mailbox_with_mail:solmail mcp

使用Solana加密货币从您的AI代理发送真实的物理邮件。 A. 模型上下文协议 该服务器使克劳德和其他人工智能代理能够向全球真实地址发送物理信件和明信片,并使用SOL支付。为罗马斗兽场特工黑客马拉松(#47)而建。

安装

npx solmail-mcp@latest

添加到MCP配置中:

{
  "mcpServers": {
    "solmail": {
      "command": "npx",
      "args": ["-y", "solmail-mcp"],
      "env": {
        "SOLANA_NETWORK": "devnet",
        "SOLANA_PRIVATE_KEY": "your_base58_private_key"
      }
    }
  }
}

特性

  • 物理邮件 --通过Lob.com打印并邮寄到200多个国家的信件
  • 索拉纳支付 --在devnet(测试)或主网(生产)上使用SOL支付
  • 无监护权的 --直接钱包控制,无中介
  • 人工智能原生 --专为MCP代理集成而构建
  • 演示模式 --使用devnet SOL和Lob测试API进行零成本测试

工具(4)

工具 说明
get_mail_quote 获取发送邮件的报价(国家、颜色选项)
send_mail 发送一封包含Solana付款的实体信件
get_wallet_balance 检查代理钱包SOL余额
get_wallet_address 获取资金钱包地址

用法示例

You: Send a thank you note to John Doe at 123 Main St, San Francisco, CA 94102

Claude: [calls get_mail_quote] Cost: $1.50 (~0.015 SOL) for domestic US mail
        [calls send_mail] Letter sent!
          Letter ID: ltr_abc123
          Tracking: 9400000000000000000000
          Payment: 0.015 SOL (tx: 5j7s...)
          Delivery: 3-5 business days

运作原理

Agent composes letter --> MCP validates address --> Solana tx signed
    --> Payment sent to merchant --> SolMail verifies on-chain
    --> Lob.com prints letter --> USPS delivers --> Tracking returned

定价

类型 价格 SOL(100美元/SOL)
美国国内 1.50美元 ~0.015瑞士镑
国际 2.50美元 ~0.025索尔
彩色印刷 +0.50美元 +0.005索尔
索拉纳交易费 约0.00025美元 约0.0000025索尔

配置

变量 必填 描述
SOLANA_PRIVATE_KEY 是 代理钱包私钥(base58)
SOLANA_NETWORK 没有 devnet (默认)或 mainnet-beta
SOLMAIL_API_URL 没有 API终结点(默认值: https://solmail.online/api)
MERCHANT_WALLET 否 自定义付款目的地

重要:为AI代理创建一个资金有限的专用钱包。永远不要使用你的主钱包。

发展

npm install && npm run build
npm run dev    # Watch mode
npm start      # Production

相关项目

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/my-feature)
  3. 提交您的更改
  4. 打开拉取请求

链接

许可证

麻省理工学院-- 紫松鼠传媒