Pumpfun Wallets MCP

🚀 Pumpfun Wallets MCP

Pump.funとPumpSwapでのウォレットの取引活動と収益性を分析するMCPサーバーです。

✨ 主な機能

• 総ウォレット数：PumpfunとPumpswap上のウォレットの総数を取得します。
• 上位収益ウォレット：過去30日間の実現利益で上位のウォレットを、順位、ウォレットアドレス、利益、最後の取引タイムスタンプとともに取得します。
• 上位取引ウォレット：通算取引額で上位のウォレットを、取引回数と米ドルでの総取引額を含めて取得します。
• ウォレット分布：取引ボリュームの階層別にウォレットの分布を表示します（ボットを除く）。これにより、取引活動の洞察が得られます。
• 表形式出力：データを見やすい表形式の文字列で返します。

📦 インストール

前提条件

• Python 3.10+
• 有効なDune Analytics APIキー

インストール手順

1. リポジトリをクローンする：

   git clone https://github.com/kukapay/pumpfun-wallets-mcp.git
   cd pumpfun-wallets-mcp
   

2. 依存関係をインストールする：

   uv sync
   

3. Claude Desktopへのインストール：

   サーバーをClaude Desktopアプリケーションとしてインストールします：

   uv run mcp install main.py --name "pumpfun-wallets-mcp"
   

   参考としての設定ファイル：

   {
      "mcpServers": {
          "Pumpfun Wallets": {
              "command": "uv",
              "args": [ "--directory", "/path/to/pumpfun-wallets-mcp", "run", "main.py" ],
              "env": { "DUNE_API_KEY": "dune_api_key"}               
          }
      }
   }
   

   /path/to/pumpfun-wallets-mcp を実際のインストールパスに置き換え、dune_api_key をDune Analyticsから取得したAPIキーに置き換えてください。

💻 使用例

サーバーは、MCPインターフェイスまたはAPIを介してアクセスできる以下のツールを提供します。

get_total_wallets()

• 説明：PumpfunとPumpswap上のウォレットの総数を取得します。
• 戻り値：整数（総ウォレット数、エラー時は0）。
• 例：

PumpfunとPumpswap上にはいくつのウォレットがありますか？

get_alpha_wallets(limit: int = 100)

• 説明：過去30日間の上位収益ウォレットを、順位、ウォレットアドレス、実現利益（米ドル）、最後の取引タイムスタンプを含めて取得します。
• パラメータ：limit（オプション、デフォルト: 100） - 返すウォレットの最大数。
• 戻り値：ウォレットデータの表形式文字列、エラー時は空文字列。
• 例：

過去30日間にPumpfunとPumpswapで最も収益が高い上位5つのウォレットを表示してください。

出力:

Rank  Wallet                                      Realized Profit  Last Tx
----  ------------------------------------------  ---------------  --------------------
1     0x123...abc                                $50000           2025-06-10 12:34:56
2     0x456...def                                $45000           2025-06-09 09:12:34
...

get_trading_wallets(limit: int = 10)

• 説明：通算取引額で上位のウォレットを、順位、ウォレットアドレス、取引回数、総取引額（米ドル）を含めて取得します。
• パラメータ：limit（オプション、デフォルト: 10） - 返すウォレットの最大数。
• 戻り値：ウォレットデータの表形式文字列、エラー時は空文字列。
• 例：

PumpfunとPumpswapで取引額が最も高い上位3つのウォレットは誰ですか？

出力:

Rank  Wallet                                      Trade Count  Total Volume
----  ------------------------------------------  -----------  ------------
1     0x789...ghi                                1500         $1000000
2     0xabc...jkl                                1200         $950000
3     0xdef...mno                                1000         $800000

get_trading_wallet_distribution()

• 説明：取引ボリュームの階層別にウォレットの分布を取得します（ボットを除く）。
• 戻り値：ボリューム階層とウォレット数の表形式文字列、エラー時は空文字列。
• 例：

PumpfunとPumpswapでの取引ボリューム別のウォレット分布はどうなっていますか？（ボットを除く）

出力:

Volume Tier      Number of Wallets
---------------  -----------------
$0 - $1000       5000
$1000 - $10000   2000
$10000+          500

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。