mcpField
S
solmail

solmail

本地服务
github.com/ExpertVagabond通信协作19 周前更新
代码仓库

关于 solmail

solmail 是供 AI Agent 使用的 MCP 服务，可通过 Solana 支付将信件和明信片寄送到全球真实地址。它提供报价、寄信及钱包信息工具，并支持 devnet 测试和 mainnet-beta。

主要功能

  1. 01向全球地址寄送实体信件
  2. 02使用 SOL 支付邮寄费用
  3. 03查询邮寄报价
  4. 04查询钱包余额和地址
  5. 05支持 devnet 测试

适用场景

  1. 01让 Agent 寄送实体感谢信
  2. 02通过 SOL 支付国际明信片邮寄
  3. 03在 devnet 测试寄信流程

MCP 相关

该 MCP 服务向客户端开放报价、寄信、钱包余额和钱包地址四种工具，使 AI Agent 能发起实体邮寄并使用 Solana 支付。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "expertvagabond-solmail": {
      "command": "npx",
      "args": [
        "-y",
        "solmail-mcp"
      ],
      "env": {
        "SOLANA_PRIVATE_KEY": "<SOLANA_PRIVATE_KEY>",
        "SOLANA_NETWORK": "<SOLANA_NETWORK>",
        "SOLMAIL_API_URL": "<SOLMAIL_API_URL>",
        "MERCHANT_WALLET": "<MERCHANT_WALLET>"
      }
    }
  }
}
启动命令npx -y solmail-mcp
需要配置的环境变量
SOLANA_PRIVATE_KEY密钥Your agent's Solana wallet private key (base58 or JSON array format)
SOLANA_NETWORKSolana network: devnet for testing, mainnet-beta for production
SOLMAIL_API_URLSolMail API endpoint
MERCHANT_WALLETMerchant wallet address for payments

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmsolmail-mcp1.0.2

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
colorboolean否是否使用彩色打印。价格增加 $0.50。
countrystring否目的地国家/地区代码（例如 US、GB、CA）。默认为 US。

详细介绍

:mailbox_with_mail: solmail-mcp

npm version License: MIT GitHub stars Solana

通过 AI Agent 使用 Solana 加密货币寄送真实的实体邮件。 这是一个 Model Context Protocol 服务，可让 Claude 和其他 AI Agent 将实体信件和明信片寄送到全球各地的真实地址，并使用 SOL 付款。专为 Colosseum Agent Hackathon（#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 多个国家/地区
  • Solana 付款 -- 在 devnet（测试）或 mainnet（生产）上使用 SOL 付款
  • 非托管 -- 直接控制钱包，无中间方
  • 原生支持 AI -- 专为 MCP Agent 集成打造
  • 演示模式 -- 使用 devnet SOL 和 Lob 测试 API 零成本测试

工具（4 个）

工具描述
get_mail_quote获取寄送邮件的价格报价（国家/地区、颜色选项）
send_mail使用 Solana 付款寄送实体信件
get_wallet_balance查看 Agent 钱包的 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 SOL
国际$2.50~0.025 SOL
彩色打印+$0.50+0.005 SOL
Solana 交易费~$0.00025~0.0000025 SOL

配置

变量必需描述
SOLANA_PRIVATE_KEY是Agent 钱包私钥（base58）
SOLANA_NETWORK否devnet（默认）或 mainnet-beta
SOLMAIL_API_URL否API 端点（默认：https://solmail.online/api）
MERCHANT_WALLET否自定义付款目标地址

重要：请为 AI Agent 创建资金有限的专用钱包。切勿使用主钱包。

开发

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

相关项目

贡献

  1. Fork 此代码库
  2. 创建功能分支（git checkout -b feature/my-feature）
  3. 提交更改
  4. 发起 Pull Request

链接

许可证

MIT -- Purple Squirrel Media

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。