PumpSwap MCP Server

PumpSwap MCP 服务

一个 MCP 服务，可让 AI Agent 与 PumpSwap 交互，实现实时代币兑换和自动化链上交易。

功能

• 购买代币：使用 SOL 购买代币，并可自定义滑点和优先费。
• 出售代币：出售代币以换取 SOL，并可配置相关参数。
• 查询代币价格：获取代币当前的 SOL 价格。
• 获取池数据：获取并显示指定代币 mint 的详细池信息。

前提条件

• Python 3.13 或更高版本
• 用于依赖管理和脚本执行的 uv
• Solana RPC 端点（例如，https://api.mainnet-beta.solana.com）
• 用于交易签名的有效 Solana 私钥

安装

1. 克隆仓库：

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

2. 安装 uv： 如果尚未安装 uv，请参阅官方 uv 安装指南。例如：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. 设置依赖项： 使用 uv 安装依赖项：

   uv sync
   

4. 配置环境变量： 在项目根目录中创建 .env.private 文件，其中包含以下变量：

   HTTPS_RPC_ENDPOINT=https://api.mainnet-beta.solana.com
   BUY_SLIPPAGE=0.3
   SELL_SLIPPAGE=0.1
   SWAP_PRIORITY_FEE=1500000
   PRIVATE_KEY=your-solana-private-key
   

   将 your-solana-private-key 替换为你的实际 Solana 私钥。

使用方法

运行 MCP 服务

使用 uv 运行服务：

uv run main.py

服务将监听 MCP 命令，并提供以下工具：

• buy_token(mint: str, sol_amount: float, user_private_key: str)：使用 SOL 购买代币。
• sell_token(mint: str, token_amount: float, user_private_key: str)：出售代币以换取 SOL。
• get_token_price(mint: str)：获取代币当前的 SOL 价格。
• get_pool_data(mint: str)：获取格式化的代币池数据。

购买代币

提示词：

Buy 0.1 SOL worth of tokens with mint address FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

这会触发 buy_token("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump", 0.1)。

预期输出：

Buy successful for 0.1 SOL of token FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump
Transaction ID: <transaction-id>
Amount: <token-amount>
Token Price (SOL): <price>

出售代币

提示词：

Sell 1000 tokens of FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

这会触发 sell_token("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump", 1000)。

预期输出：

Sell successful for 1000 tokens of FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump
Transaction ID: <transaction-id>
Amount: <sol-amount>
Token Price (SOL): <price>

获取代币价格

提示词：

What is the current price of the token with mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump?

这会触发 get_token_price("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump")。

预期输出：

The current price of token FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump is <price> SOL.

获取池数据

提示词：

Show me the pool data for the token with mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump.

这会触发 get_pool_data("FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump")。

预期输出：

PumpPool Data for mint FC988ZAKRPc26wefDAxcYWB8kgbJTH4Tg3qDvf7xpump:
Pool Bump: <bump>
Index: <index>
Creator: <creator-pubkey>
Base Mint: <base-mint>
Quote Mint: <quote-mint>
LP Mint: <lp-mint>
Pool Base Token Account: <base-account>
Pool Quote Token Account: <quote-account>
LP Supply: <supply>

环境变量

服务使用以下环境变量，这些变量从 .env.private 加载：

变量	描述	默认值
HTTPS_RPC_ENDPOINT	Solana RPC 端点 URL	https://api.mainnet-beta.solana.com
BUY_SLIPPAGE	买入交易的滑点容差	0.3（30%）
SELL_SLIPPAGE	卖出交易的滑点容差	0.1（10%）
SWAP_PRIORITY_FEE	交易的优先费（单位为 lamports）	1500000
PRIVATE_KEY	用于交易签名的 Solana 私钥	无（必填）

请确保已设置 PRIVATE_KEY，否则服务会报错。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

免责声明

本软件会与去中心化金融（DeFi）协议交互，并处理私钥等敏感数据。使用风险由你自行承担。请确保 .env.private 文件安全，切勿分享你的私钥。对于因使用本软件而导致的任何财务损失或安全问题，作者概不负责。