ponzu

@ponzu_app/mcp

Ponzu 用の MCP サーバー。AI エージェントを介して Ethereum 上でトークンをデプロイし、プレセールで購入し、スワップやファーミングを行います。

ツール（17）

ツール	説明
ponzu_get_skill	Ponzu のドキュメント全体（SKILL.md）を取得
ponzu_get_addresses	設定済みネットワークのプロトコルコントラクトアドレスを取得
ponzu_calc_pricing	調達目標額（ETH）からプレセールの価格曲線を計算
ponzu_deploy	1 回のトランザクションで 9 つのコントラクトからなるトークンシステム全体をデプロイ
ponzu_get_presale_info	プレセールの状態（購入可能なトークン数、ローンチ状況など）を読み取り
ponzu_presale_buy	プレセールでトークンを購入
ponzu_presale_refund	プレセールのトークンを払い戻し（20% のペナルティ）
ponzu_trigger_launch	プレセール完売時に DEX のローンチを実行
ponzu_claim_tokens	プレセールで権利確定したトークンを請求
ponzu_claim_eth	プレセールの ETH 報酬を請求
ponzu_swap_eth_for_tokens	PonzuSwap DEX でトークンを購入
ponzu_swap_tokens_for_eth	PonzuSwap DEX でトークンを売却
ponzu_zap_eth	1 回のトランザクションで ETH を LP トークンに変換
ponzu_farm_stake	ファームに LP トークンをステーク
ponzu_farm_unstake	LP トークンをアンステーク（LiquidityCard NFT をバーン）
ponzu_farm_claim	ファームから基軸トークンの報酬を請求
ponzu_farm_claim_eth	ファームから WETH 報酬を請求

設定

環境変数

変数	必須	デフォルト	説明
PONZU_PRIVATE_KEY	書き込み操作の場合	—	トランザクションの署名に使用する 16 進数の秘密鍵
PONZU_RPC_URL	いいえ	Public RPC	Ethereum RPC エンドポイント
PONZU_NETWORK	いいえ	mainnet	mainnet または sepolia

Claude Desktop / Claude Code

MCP 設定（~/.claude/config.json または Claude Desktop の設定）に追加します。

{
  "mcpServers": {
    "ponzu": {
      "command": "npx",
      "args": ["-y", "@ponzu_app/mcp"],
      "env": {
        "PONZU_PRIVATE_KEY": "0x...",
        "PONZU_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
        "PONZU_NETWORK": "mainnet"
      }
    }
  }
}

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "ponzu": {
      "command": "npx",
      "args": ["-y", "@ponzu_app/mcp"],
      "env": {
        "PONZU_PRIVATE_KEY": "0x...",
        "PONZU_RPC_URL": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
        "PONZU_NETWORK": "mainnet"
      }
    }
  }
}

読み取り専用モード

読み取り専用ツール（ponzu_get_skill、ponzu_get_addresses、ponzu_calc_pricing、ponzu_get_presale_info）を使う場合は、PONZU_PRIVATE_KEY を省略します。書き込み操作では、キーを指定するよう求める明確なエラーが返されます。

開発

yarn install
yarn build        # compiles TypeScript
yarn dev          # watch mode via tsx