代币交易协议服务器

一个用于与Pump.fun平台交互的MCP服务器,支持AI助手创建、购买和出售Solana上的代币。

  • by noahgsolomon
  • TypeScript
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 noahgsolomon/pumpfun-mcp-server

使用说明

pumpfun-mcp

一种用于与客户端交互的模型上下文协议(MCP)服务器 泵轮 Solana上的平台。该服务器使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. 创建一个 .env 包含Solana RPC URL的文件:

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

    您可以从以下网址获取免费的RPC URL 赫利乌斯.

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

    PRIVATE_KEY=your-base58-encoded-private-key
    

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

    node convert-key.js
    

    这将创建一个 default.json 文件在 .keys 用你的键盘对文件夹。

  4. 构建项目:

    npm run build
    
  5. 运行MCP服务器:

    node build/index.js
    

组件

工具

  • 获取令牌信息

    • 获取有关Pump.fun令牌的信息
    • 输入参数:
      • tokenAddress (string,必填):令牌的薄荷地址
  • 创建令牌

    • 创建新的Pump.fun令牌
    • 输入参数:
      • name (字符串,必填):令牌名称
      • symbol (字符串,必填):令牌符号
      • description (字符串,必填):令牌描述
      • imageUrl (字符串,可选):本地图像文件的路径
      • initialBuyAmount (数字,必填):SOL中的初始买入金额(最小0.0001)
      • accountName (字符串,可选):要使用的帐户名称(默认为“默认”)
  • 购买代币

    • 购买Pump.fun代币
    • 输入参数:
      • tokenAddress (string,必填):令牌的薄荷地址
      • buyAmount (数字,必填):购买SOL的金额(最低0.0001)
      • accountName (字符串,可选):要使用的帐户名称(默认为“默认”)
      • slippageBasisPoints (数字,可选):基点滑动公差(默认为100)
  • 出售代币

    • 出售Pump.fun代币
    • 输入参数:
      • tokenAddress (string,必填):令牌的薄荷地址
      • sellAmount (number,必填):要出售的代币数量(使用0表示全部出售)
      • accountName (字符串,可选):要使用的帐户名称(默认为“默认”)
      • slippageBasisPoints (数字,可选):基点滑动公差(默认为100)
  • 列出帐户

    • 列出密钥文件夹中的所有帐户
    • 无需输入参数
  • 获取账户余额

    • 获取账户的SOL和代币余额
    • 输入参数:
      • accountName (字符串,可选):要检查的帐户名称(默认为“默认”)
      • tokenAddress (字符串,可选):用于检查余额的令牌地址

账户管理

MCP在中自动创建和管理Solana密钥对 .keys 文件夹。每个密钥对都存储为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