pumpfun-mcp

pumpfun-mcp

一个用于在 Solana 上与 Pump.fun 平台交互的模型上下文协议（MCP）服务。此服务可让 AI 助手在 Pump.fun 平台上创建、购买和出售代币。

用法

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"], // note this should be YOUR absolute path to index.js, not mine.
      "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（string，必填）：代币的铸币地址

• create-token

  • 创建新的 Pump.fun 代币
  • 输入参数：
    • name（string，必填）：代币名称
    • symbol（string，必填）：代币符号
    • description（string，必填）：代币描述
    • imageUrl（string，可选）：本地图像文件的路径
    • initialBuyAmount（number，必填）：初始购买金额，单位为 SOL（最小值为 0.0001）
    • accountName（string，可选）：要使用的账户名称（默认为 "default"）

• buy-token

  • 购买 Pump.fun 代币
  • 输入参数：
    • tokenAddress（string，必填）：代币的铸币地址
    • buyAmount（number，必填）：购买金额，单位为 SOL（最小值为 0.0001）
    • accountName（string，可选）：要使用的账户名称（默认为 "default"）
    • slippageBasisPoints（number，可选）：滑点容忍度，单位为基点（默认为 100）

• sell-token

  • 出售 Pump.fun 代币
  • 输入参数：
    • tokenAddress（string，必填）：代币的铸币地址
    • sellAmount（number，必填）：要出售的代币数量（输入 0 即出售全部）
    • accountName（string，可选）：要使用的账户名称（默认为 "default"）
    • slippageBasisPoints（number，可选）：滑点容忍度，单位为基点（默认为 100）

• list-accounts

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

• get-account-balance

  • 获取账户的 SOL 和代币余额
  • 输入参数：
    • accountName（string，可选）：要查询的账户名称（默认为 "default"）
    • tokenAddress（string，可选）：要查询余额的代币地址

账户管理

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

创建代币时，铸币密钥对也会保存到 .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