🚀 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 密钥
安装步骤
-
克隆仓库：
git clone https://github.com/kukapay/pumpfun-wallets-mcp.git cd pumpfun-wallets-mcp -
安装依赖：
uv sync -
安装到 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 文件。