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 文件。