pump.fun Solana Data

@three-ws/pumpfun-mcp

免费的只读 pump.fun + Solana MCP 服务 — 代币发现、链上分析和实时 3D 快照。无需 API 密钥。

安装 · 快速开始 · 工具 · 配置 · three.ws

---

一个面向 pump.fun 和 Solana 的免费只读 Model Context Protocol 服务。它为 Claude 或任何 MCP 客户端提供实时代币发现、链上联合曲线和持有者分析、创建者费用领取追踪、Solana Name Service 解析、KOL 信号、只读兑换报价，以及可分享的实时 3D 代币快照。所有 Solana RPC 和 pump.fun API 调用都在规范的 three.ws 后端上运行，因此数据是实时链上数据，而客户端无需任何配置：无需 API 密钥、无需 RPC URL、无需钱包。

安装

Claude Code（一行命令）

claude mcp add pumpfun -- npx -y @three-ws/pumpfun-mcp

Claude Desktop / Cursor / 任意 MCP 客户端

添加到你的 MCP 配置（claude_desktop_config.json、.cursor/mcp.json、.mcp.json 等）：

{
	"mcpServers": {
		"pumpfun": {
			"command": "npx",
			"args": ["-y", "@three-ws/pumpfun-mcp"]
		}
	}
}

重启客户端后，pump.fun 工具就会出现。无需安装。

直接运行

npx -y @three-ws/pumpfun-mcp
# or install globally and run the bin
npm i -g @three-ws/pumpfun-mcp && pumpfun-mcp

快速开始

该服务通过 stdio JSON-RPC 通信——你的 MCP 客户端会通过上述 npx 命令启动它。配置完成后，用自然语言向客户端提问，它会选择合适的工具：

"What's trending on pump.fun right now?"        → get_trending_tokens
"Show the bonding curve for <mint>"             → get_bonding_curve
"Who are the top holders of <mint>?"            → get_token_holders
"Resolve bonfida.sol"                           → sns_resolve
"Build a 3D snapshot for <mint>"                → pumpfun_token_3d

工具

所有工具均为只读——不会签署或发送任何交易。pumpfun_quote_swap 仅提供报价；pumpfun_vanity_mint 会返回密钥对，供你自行使用。

六个工具需要索引器。 search_tokens、get_trending_tokens、get_new_tokens、get_graduated_tokens、get_king_of_the_hill 和 get_creator_profile 需要 pump.fun 索引器（PUMPFUN_BOT_URL）。托管端点 three.ws/api/pump-fun-mcp 未配置索引器，因此会从 tools/list 中过滤掉这六个工具；连接到该端点时，这些工具不会出现。在你自己的部署中设置环境变量后，这些工具就会恢复，无需修改代码。其他所有工具（包括 get_token_trades）都基于链上数据运行，无需索引器。调用 pumpfun_bot_status 查看你当前使用的是哪种配置。请注意，没有索引器时，get_token_details 只会返回 SPL 账户信息（name、symbol 和 uri 会返回 null）。

托管端点还提供下表未列出的三个工具：get_coin_intel、get_oracle_conviction 和 pumpfun_upload_metadata。

工具	功能说明
search_tokens	按名称、符号或 mint 搜索 pump.fun 代币。
get_token_details	获取 mint 的完整元数据。
get_bonding_curve	获取仍处于曲线上的代币的真实／虚拟报价储备及毕业进度（链上）。v3 买入若清空曲线，会通过合成迁移完成。
get_token_trades	获取代币近期买入／卖出记录。
get_trending_tokens	按市值列出热门代币。
get_new_tokens	获取最近上线的代币。
get_graduated_tokens	获取已毕业至其 PumpSwap 池的代币。
get_king_of_the_hill	获取仍处于绑定曲线上的最高市值代币。
get_token_holders	获取顶级持有者及持仓集中度分析（链上）。
get_creator_profile	获取创作者的代币及 Rug Pull 风险标记。
kol_leaderboard	按 24 小时／7 天／30 天时间段的盈亏对顶级 KOL 交易者进行排名。
pumpfun_list_claims	获取近期创作者手续费领取事件（链上）。v3 曲线／v2 池交易产生的手续费会在归集后显示。
pumpfun_watch_claims	获取指定回溯时间段内创作者的手续费领取记录。
pumpfun_first_claims	获取创作者首次领取记录——这可能是套现信号。
pumpfun_quote_swap	获取已毕业代币的只读 PumpSwap AMM 兑换报价（无需签名）。价格基于金库和带符号、通常为负数的 virtual_quote_reserves。
pumpfun_watch_whales	在短时间段内收集某代币的大额交易。
pumpfun_vanity_mint	生成自定义 Solana 密钥对（密钥返回给调用方，绝不存储）。
sns_resolve	将 .sol 域名解析为其所有者钱包。
sns_reverseLookup	反向查询钱包对应的主 .sol 域名。
social_cashtag_sentiment	对提供的帖子进行基于确定性词典的情绪分析。
social_x_post_impact	将 X 帖子与绑定曲线价格影响关联起来。
pumpfun_bot_status	获取 pump.fun 索引器后端的配置和运行状况——包括 configured、healthy 和 ping 延迟。始终可用。
pumpfun_token_3d	实时 3D 快照：组合代币的元数据、持有者和毕业信息，并生成可分享的 three.ws/coin3d 查看器（旋转的硬币徽章、持有者星系和毕业环），同时返回深层链接、可嵌入的 iframe 及底层数据。
启动时会从后端获取实时工具列表；同时随包附带一份副本作为离线备用，因此全新安装后始终会展示正确的工具列表。

价格如何计算

pump.fun 币有两个生命周期阶段，分别由两个不同的链上账户定价。此处的每个工具都只属于其中一个阶段，从错误的账户读取数值，是得出看似可信、实际错误的答案的典型原因。

毕业前：pump 程序的 BondingCurve 账户。 现货价格为 virtual_quote_reserves / virtual_token_reserves。当非 SOL 报价资产成为可能后，上游重命名了这些报价侧字段（virtual_sol_reserves → virtual_quote_reserves、real_sol_reserves → real_quote_reserves），曲线也新增了 quote_mint；迄今创建的所有币都默认使用 SOL。重命名后的字段仍是相同偏移处的同一个 u64，因此响应字段 virtualSolReserves / solReserves 保留原名，并继续以 SOL 计价。由 get_bonding_curve 和 social_x_post_impact 提供。

毕业后：PumpSwap（pump_amm）的 Pool 账户。 报价基于有效报价储备：

effective_quote_reserves = pool_quote_token_account.amount + pool.virtual_quote_reserves

pool.virtual_quote_reserves 是追加到 Pool 中的字段，类型为有符号 i128。正值表示增加保存在金库之外的深度。自 2026-09-30 起，该值通常为负数：PumpSwap v2 交易（buy_v2、sell_v2、buy_exact_quote_in_v2）和 multi_hop_swap 会将协议费用和创建者费用保留在报价金库中，直到通过 sweep 支付出去，并在此处减去该金额，避免未结算费用被计作流动性。因此，单独使用 quote_reserve 会高估深度，effective_quote_reserve 可能低于它，而且程序保证两者之和永不为负。读取该字段时必须将其视为有符号整数：绝不能按无符号数读取、截断为 0 或取绝对值。该字段出现前创建的池会将其读作 0。买入和卖出都基于有效数值定价，priceImpactBps 衡量的是相对于其所代表现货价格的执行情况，因此虚拟流动性体现为深度，而不是影响。基础侧保持不变：仍使用原始的 pool_base_token_account.amount。由 pumpfun_quote_swap 提供。

两个 virtual_quote_reserves 是不同账户上的不同字段，只是名称恰好相同。一个币只会有其中一个，绝不会同时拥有两个。如果 get_bonding_curve 返回 complete: true，就不要再读取曲线，而应改为对池报价。

交接：合成迁移。 清空曲线的 v3 曲线买入（buy_v3、buy_exact_quote_in_v3）没有最大规模限制。它会按曲线价格买下曲线剩余的代币，完成曲线，再按 PumpSwap 池即将开盘的价格买入剩余部分，因此大额的最后一笔买入不会受 realTokenReserves 限制。Mayhem 币除外。完成这笔买入后，在迁移完成前，所有曲线交易都会失败。链下报价使用 @pump-fun/pump-sdk 4.0.0 中的 getBuyV3QuoteAmountFromTokenAmount / getBuyV3TokenAmountFromQuoteAmount，以及来自 fetchBuyState 的 curveBaseTokenBalance。

创建者费用在 sweep 之前不会结算。 v3 曲线交易和 v2 池交易不会逐笔支付创建者费用；费用会留在曲线的 BondingCurve.creator_fee 和池的 Pool.creator_fees 中，直到 sweep_creator_fee 将其转入创建者金库，通常会在同一笔交易中、领取之前执行。领取工具报告的是已领取金额，因此，仍留在曲线或池中的费用，在 sweep 之前不会计入任何领取结果。

上游参考：pump-public-docs，特别是 NEGATIVE_VIRTUAL_QUOTE_RESERVES.md、SYNTHETIC_MIGRATION.md 和 instructions/SWEEP_FEES.md。

查看工具

npx -y @modelcontextprotocol/inspector npx @three-ws/pumpfun-mcp

示例

可运行的示例位于 examples/：

node examples/list-tools.mjs     # every tool the backend currently serves, with schemas
node examples/token-report.mjs   # live on-chain report for one mint

这两个示例都会通过 stdio 启动此服务，并读取 Solana 主网实时数据。这里的所有工具都是免费的，只读。请参阅 examples/README.md，了解预期输出，其中包括为什么宣传的工具数量取决于后端是否配置了索引器。

配置

无需配置。可选的覆盖项如下：

环境变量	默认值	用途
PUMPFUN_MCP_URL	https://three.ws/api/pump-fun-mcp	后端端点。仅在可自托管处理程序时覆盖。

工作原理

此软件包是一个轻量级的 stdio ↔ HTTP 桥接器。它会将 MCP tools/call 请求转发到规范的 three.ws pump.fun JSON-RPC 后端，由该后端执行实际的 Solana RPC 读取和 pump.fun API 查询。这样可以保留一个权威实现，不会向客户端发送密钥，并确保工具集自动保持最新。

pumpfun_token_3d 是一个原生工具：它在进程内运行，编排多次后端读取（元数据 + 联合曲线 + 持有者），并从链上元数据 URI 获取代币徽标，然后返回指向 three.ws 3D 查看器的深层链接。它无需额外密钥，也不会引入新的后端依赖。

错误

失败会以 MCP 工具错误（isError: true）的形式呈现，并包含真实原因，而不会静默返回空结果：

错误文本	含义	处理方式
Backend request failed: …	桥接器无法访问后端（网络错误、非 2xx 响应、JSON 格式错误）。	检查连接和 PUMPFUN_MCP_URL；可安全重试。
[-32602] …	参数无效（例如，调用 pumpfun_token_3d 时未提供 mint）。	修正消息中指出的参数。
[-32004] no on-chain data for <mint>: …	pumpfun_token_3d 未找到该 mint 的元数据、联合曲线或持有者数据。	验证 mint 地址和网络（mainnet/devnet）。
[<code>] <message>	其他任何后端 JSON-RPC 错误（未知工具、索引器不可用、链上读取失败），会原样传递。	消息会说明上游原因；临时索引器错误可安全重试。

pumpfun_token_3d 会优雅降级：如果三个来源中只有部分读取成功，它仍会返回快照，并标记缺失的部分（no holder data available、no bonding-curve data available）；只有在三项全部失败时才会报错。

要求

• Node.js >= 20（来自 engines）。
• 无需 API 密钥、RPC URL 或钱包。需要能够通过出站 HTTPS 连接到 three.ws 后端（或你的 PUMPFUN_MCP_URL）。

相关

• @three-ws/mcp-server — 收费的 three.ws MCP，通过 x402 结算（文本→3D 网格、虚拟形象、姿势种子、ERC-8004 声誉，以及收费的 pump_snapshot）。

链接

• 主页：https://three.ws
• 更新日志：https://three.ws/changelog
• 问题反馈：https://github.com/nirholas/three.ws/issues
• 许可证：Apache-2.0。请参阅 LICENSE。

---

_{属于 three.ws SDK 套件的一部分 — 3D AI Agent、链上身份和 Agent 支付。
网站 · 更新日志 · GitHub}