Pumpfun Wallets MCP

🚀 Pumpfun Wallets MCP

Pumpfun Wallets MCP 是一個 MCP 服務器，用於分析 Pump.fun 和 PumpSwap 上錢包的交易活動和盈利能力。

🚀 快速開始

Pumpfun Wallets MCP 可對 Pump.fun 和 PumpSwap 上錢包的交易活動與盈利能力進行分析。你可以通過該服務器獲取錢包總數、盈利最多的錢包、交易最活躍的錢包等信息。

✨ 主要特性

• 錢包總數統計：獲取 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）。
• 示例：

How many wallets are there on Pumpfun and Pumpswap?

get_alpha_wallets(limit: int = 100)

• 描述：獲取過去 30 天內盈利最多的錢包，包括排名、錢包地址、已實現利潤（美元）和最後交易時間戳。
• 參數：limit（可選，默認值：100） - 要返回的最大錢包數量。
• 返回值：包含錢包數據的表格化字符串，出錯時返回空字符串。
• 示例：

Show me the top 5 most profitable wallets on Pumpfun and Pumpswap for the last 30 days.

輸出:

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） - 要返回的最大錢包數量。
• 返回值：包含錢包數據的表格化字符串，出錯時返回空字符串。
• 示例：

Who are the top 3 wallets with the highest trading volume on Pumpfun and Pumpswap?

輸出:

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()

• 描述：獲取按交易量層級劃分的錢包分佈（不包括機器人錢包）。
• 返回值：包含交易量層級和錢包數量的表格化字符串，出錯時返回空字符串。
• 示例：

What is the distribution of wallets by trading volume on Pumpfun and Pumpswap, excluding bots?

輸出:

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

📄 許可證

本項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE 文件。