pumpfun-mcp

一个用于与 Solana 上的 Pump.fun 平台交互的模型上下文协议 (MCP) 服务器。该服务器使 AI 助手能够在 Pump.fun 平台上创建、购买和出售代币。

<img src="https://pump.fun/logo.png" width="250" height="250" alt="Pump.fun MCP Demo">

用法

https://github.com/user-attachments/assets/0b0f1f6f-6ea6-4ca8-92a8-b4cc895814e4

要将此服务器与 Claude 或其他 MCP 兼容的 AI 助手一起使用，请将以下配置添加到您的 MCP 客户端：

如果您在 MacOS 上并且想在 Claude Desktop 中运行它，请在您的 ~/Library/Application \Support/Claude/claude_desktop_config.json 文件中写入以下内容：

{
  "mcpServers": {
    "pumpfun": {
      "command": "node",
      "args": ["/Users/noahsolomon/Desktop/pumpfun-mcp/build/index.js"], // 注意：这应该是您 index.js 的绝对路径，而不是我的。
      "env": {
        "HELIUS_RPC_URL": "https://your-helius-rpc-url.com"
      }
    }
  }
}

将 https://your-helius-rpc-url.com 替换为您的 Helius RPC URL。

安装

1. 克隆此存储库：

   git clone https://github.com/noahgsolomon/pumpfun-mcp.git
   cd pumpfun-mcp
   

2. 安装依赖项：

   npm install
   

3. 创建一个包含您的 Solana RPC URL 的 .env 文件：

   HELIUS_RPC_URL=https://your-helius-rpc-url.com
   

   您可以从 Helius 获取免费的 RPC URL。

   要使用现有的 Solana 钱包，请将您的私钥添加到 .env 文件中：

   PRIVATE_KEY=your-base58-encoded-private-key
   

   然后运行转换脚本以创建密钥对文件：

   node convert-key.js
   

   这将在 .keys 文件夹中创建一个包含您的密钥对的 default.json 文件。

4. 构建项目：

   npm run build
   

5. 运行 MCP 服务器：

   node build/index.js
   

组件

工具

• get-token-info

  • 获取有关 Pump.fun 代币的信息
  • 输入参数：
    • tokenAddress (字符串，必需)：代币的 mint 地址

• create-token

  • 创建一个新的 Pump.fun 代币
  • 输入参数：
    • name (字符串，必需)：代币名称
    • symbol (字符串，必需)：代币符号
    • description (字符串，必需)：代币描述
    • imageUrl (字符串，可选)：本地图像文件的路径
    • initialBuyAmount (数字，必需)：初始购买金额，以 SOL 为单位（最小 0.0001）
    • accountName (字符串，可选)：要使用的帐户名称（默认为“default”）

• buy-token

  • 购买 Pump.fun 代币
  • 输入参数：
    • tokenAddress (字符串，必需)：代币的 mint 地址
    • buyAmount (数字，必需)：购买金额，以 SOL 为单位（最小 0.0001）
    • accountName (字符串，可选)：要使用的帐户名称（默认为“default”）
    • slippageBasisPoints (数字，可选)：滑点容忍度，以基点为单位（默认为 100）

• sell-token

  • 出售 Pump.fun 代币
  • 输入参数：
    • tokenAddress (字符串，必需)：代币的 mint 地址
    • sellAmount (数字，必需)：要出售的代币数量（使用 0 出售所有代币）
    • accountName (字符串，可选)：要使用的帐户名称（默认为“default”）
    • slippageBasisPoints (数字，可选)：滑点容忍度，以基点为单位（默认为 100）

• list-accounts

  • 列出 keys 文件夹中的所有帐户
  • 无需输入参数

• get-account-balance

  • 获取帐户的 SOL 和代币余额
  • 输入参数：
    • accountName (字符串，可选)：要检查的帐户名称（默认为“default”）
    • tokenAddress (字符串，可选)：要检查余额的代币地址

帐户管理

MCP 会自动在 .keys 文件夹中创建和管理 Solana 密钥对。每个密钥对都存储为 JSON 文件，帐户名称作为文件名。

创建代币时，mint 密钥对也会保存在 .keys 文件夹中，前缀为 mint-。

要将 MCP 与您自己的帐户一起使用，您需要：

1. 将您的私钥添加到 .env 文件并运行 node convert-key.js
2. 该钱包中有足够的 SOL

独立脚本

该项目包括几个可以直接运行的独立脚本：

• 获取代币信息: node build/get-token-info.js <token_address>
• 创建代币: node build/create-token.js <name> <symbol> <description> <initial_buy_amount> [account_name] [image_url]
• 购买代币: node build/buy-token.js <token_address> <buy_amount_sol> [account_name] [slippage_basis_points]
• 出售代币: node build/sell-token.js <token_address> <sell_amount> [account_name] [slippage_basis_points]
• 列出帐户: node build/list-accounts.js
• 获取帐户余额: node build/get-token-balance.js <account_name> [token_address]

重要提示

• 安全性: 密钥对以未加密的形式存储在 .keys 文件夹中。请确保适当地保护此文件夹。
• 费用: Solana 上的所有交易都需要 SOL 作为交易费用。请确保您的帐户有足够的 SOL。
• 滑点: 默认滑点容忍度为 1%（100 个基点）。您可以为每笔交易调整此值。
• 图像: 创建带有图像的代币时，您必须提供图像的本地文件路径。不支持远程 URL。

开发

项目结构

• src/index.ts: 主要 MCP 服务器入口点
• src/get-token-info.ts: 代币信息检索
• src/create-token.ts: 代币创建功能
• src/buy-token.ts: 代币购买功能
• src/sell-token.ts: 代币出售功能
• src/list-accounts.ts: 帐户列表功能
• src/get-token-balance.ts: 帐户余额检查
• src/utils.ts: 共享实用程序函数
• convert-key.js: 用于将 base58 私钥转换为密钥对 JSON 文件的实用程序

构建

npm run build