solmail

:mailbox_with_mail: solmail-mcp

AI エージェントから Solana 暗号通貨を使って、実際の郵便物を送れます。 Model Context Protocol サーバーにより、Claude やその他の AI エージェントが、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"
      }
    }
  }
}

機能

• 実際の郵便物 -- 200 か国以上に、Lob.com 経由で印刷した手紙を郵送します
• Solana 決済 -- devnet（テスト）または mainnet（本番）で SOL を使って支払います
• 非カストディアル -- ウォレットを直接管理し、仲介者は介在しません
• AI ネイティブ -- 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 SOL
国際郵便	$2.50	約 0.025 SOL
カラー印刷	+$0.50	+0.005 SOL
Solana のトランザクション手数料	約 $0.00025	約 0.0000025 SOL

設定

変数	必須	説明
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

関連プロジェクト

• solana-mcp-server-app -- Solana ウォレット + DeFi MCP
• coldstar-colosseum -- エアギャップ型 Solana 保管庫
• ordinals-mcp -- Bitcoin Ordinals MCP サーバー
• cpanel-mcp -- cPanel ホスティング MCP サーバー

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/my-feature）
3. 変更をコミットします
4. プルリクエストを作成します

リンク

• ウェブサイト | npm | MCP ドキュメント

ライセンス

MIT -- Purple Squirrel Media