pumpfun-mcp-server

🚀 泵.fun-MCP

泵.fun-MCP 是一个与 Pump.fun 平台在 Solana 上交互的 Model Context Protocol（MCP）服务器。借助该服务器，AI 助手能够在 Pump.fun 平台上创建、购买和出售代币，为用户提供便捷的代币交易体验。

🚀 快速开始

你可以通过以下链接访问项目仓库：https://github.com/your-username/pumpfun-mcp

✨ 主要特性

• 代币交互：支持在 Pump.fun 平台上创建、购买和出售代币。
• 账户管理：自动创建并管理 Solana 密钥对，方便用户操作。
• 独立脚本：提供多个可直接运行的独立脚本，便于执行常见操作。

📦 安装指南

克隆仓库

在终端中运行以下命令以克隆此项目：

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

安装依赖

安装项目所需的依赖项：

npm install

创建配置文件

创建一个名为 .env 的文件，并添加以下内容，确保 Helius RPC URL 和 MPC 费用地址正确：

HELIUS_RPC_URL=https://api.helius.dev/v0
MPC_FEE_ADDRESS=So11nWw5LEthHzNHv3s82ohw69jznyrXuYTuojQ7hPFWtv

转换现有钱包

如果你已有 Solana 钱包的私钥，可以使用以下命令将其转换为密钥对文件：

node convert-key.js --private_key your_private_key_here --account_name your_account_name

💻 使用示例

配置说明

要配置 Claude 或其他 MCP 兼容的 AI 助手，请按照以下步骤操作：

1. 打开你的 AI 助手设置界面。
2. 在模型上下文协议（MCP）部分，添加以下内容：
3. 将以下路径和命令复制到相应的位置：

# 示例命令
cd /path/to/pumpfun-mcp
npm run start -- --token_address your_token_address

独立脚本使用

项目提供了一些可以直接运行的独立脚本：

• 获取代币信息：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]

📚 详细文档

项目组件

工具功能

• 获取代币信息：src/get-token-info.ts - 获取指定代币的信息。
• 创建代币：src/create-token.ts - 创建新的代币并设置初始购买价格。
• 购买代币：src/buy-token.ts - 使用 SOL 购买指定地址的代币。
• 出售代币：src/sell-token.ts - 出售持有的代币。
• 列出账户：src/list-accounts.ts - 列出所有管理的 Solana 账户。
• 获取余额：src/get-token-balance.ts - 检查指定账户的 SOL 和代币余额。

账户管理

MCP 会自动创建并管理 Solana 密钥对，在 .keys 文件夹中保存为 JSON 文件，每个密钥对以账户名称作为文件名。在创建代币时，还会将生成的铸造密钥对保存到 .keys 文件夹中，并带有 mint- 前缀。

项目结构

• 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

执行测试

要运行测试脚本，请确保安装了所有依赖项，然后运行：

npm test

使用注意事项

1. 安全性：.keys 文件夹中的密钥对未加密，请确保妥善保管。
2. 费用：所有 Solana 交易均需消耗 SOL 作为手续费，确保账户中有足够的 SOL。
3. 滑点容忍度：默认滑点容忍度为 1%（100 个基点），可根据需要进行调整。

🔧 技术细节

该项目是一个与 Solana 区块链和 Pump.fun 平台交互的 MCP 服务器。它使用 Node.js 和 npm 进行开发和依赖管理，通过特定的脚本和工具实现了代币的创建、购买、出售等功能，并对 Solana 账户进行管理。项目利用 Solana 的 API 与区块链进行交互，确保交易的安全性和可靠性。

📄 许可证

此项目受 MIT License 保护。

贡献指南

欢迎贡献！请参考 CONTRIBUTING.md 了解如何为该项目做出贡献。