pumpfun-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la plataforma Pump.fun en Solana. Este servidor permite a los asistentes de IA crear, comprar y vender tokens en la plataforma Pump.fun.

Uso

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

Para utilizar este servidor con Claude u otros asistentes de IA compatibles con MCP, agregue la siguiente configuración a su cliente MCP:

Si estás en MacOS y quieres ejecutar esto en Claude Desktop, en tu archivo ~/Library/Application\Support/Claude/claude_desktop_config.json, escribe lo siguiente:

Reemplace https://your-helius-rpc-url.com con su URL de Helius RPC .

Instalación

1. Clonar este repositorio:

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

2. Instalar dependencias:

   npm install

3. Cree un archivo .env con su URL RPC de Solana:

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

   Puede obtener una URL RPC gratuita de Helius .

   Para utilizar una billetera Solana existente, agregue su clave privada al archivo .env :

   PRIVATE_KEY=your-base58-encoded-private-key

   Luego ejecute el script de conversión para crear un archivo de par de claves:

   node convert-key.js

   Esto creará un archivo default.json en la carpeta .keys con su par de claves.

4. Construir el proyecto:

   npm run build

5. Ejecute el servidor MCP:

   node build/index.js

Componentes

Herramientas

• obtener información del token

  • Obtenga información sobre un token de Pump.fun

  • Parámetros de entrada:

    • tokenAddress (cadena, obligatoria): la dirección de acuñación del token

• crear token

  • Crea un nuevo token Pump.fun

  • Parámetros de entrada:

    • name (cadena, obligatorio): nombre del token

    • symbol (cadena, obligatorio): Símbolo de token

    • description (cadena, obligatoria): Descripción del token

    • imageUrl (cadena, opcional): ruta al archivo de imagen local

    • initialBuyAmount (número, obligatorio): importe de compra inicial en SOL (mín. 0,0001)

    • accountName (cadena, opcional): nombre de la cuenta a utilizar (el valor predeterminado es "predeterminado")

• comprar token

  • Compra un token de Pump.fun

  • Parámetros de entrada:

    • tokenAddress (cadena, obligatoria): la dirección de acuñación del token

    • buyAmount (número, requerido): Monto a comprar en SOL (mín. 0,0001)

    • accountName (cadena, opcional): nombre de la cuenta a utilizar (el valor predeterminado es "predeterminado")

    • slippageBasisPoints (número, opcional): Tolerancia de deslizamiento en puntos básicos (predeterminado en 100)

• token de venta

  • Vender un token de Pump.fun

  • Parámetros de entrada:

    • tokenAddress (cadena, obligatoria): la dirección de acuñación del token

    • sellAmount (número, obligatorio): Cantidad de tokens a vender (use 0 para vender todos)

    • accountName (cadena, opcional): nombre de la cuenta a utilizar (el valor predeterminado es "predeterminado")

    • slippageBasisPoints (número, opcional): Tolerancia de deslizamiento en puntos básicos (predeterminado en 100)

• cuentas de lista

  • Enumere todas las cuentas en la carpeta de claves

  • No se requieren parámetros de entrada

• obtener el saldo de la cuenta

  • Obtenga los saldos de SOL y tokens de una cuenta

  • Parámetros de entrada:

    • accountName (cadena, opcional): nombre de la cuenta a verificar (predeterminado "predeterminado")

    • tokenAddress (cadena, opcional): Dirección del token para consultar el saldo

Gestión de cuentas

El MCP crea y administra automáticamente pares de claves de Solana en la carpeta .keys . Cada par de claves se almacena como un archivo JSON con el nombre de la cuenta como nombre de archivo.

Al crear un token, el par de claves mint también se guarda en la carpeta .keys con el prefijo mint- .

Para utilizar el MCP con su propia cuenta, necesita:

1. Agregue su clave privada al archivo .env y ejecute node convert-key.js

2. Tenga suficiente SOL en esa billetera

Scripts independientes

El proyecto incluye varios scripts independientes que se pueden ejecutar directamente:

• Obtener información del token : node build/get-token-info.js <token_address>

• Crear token : node build/create-token.js <name> <symbol> <description> <initial_buy_amount> [account_name] [image_url]

• Comprar token : node build/buy-token.js <token_address> <buy_amount_sol> [account_name] [slippage_basis_points]

• Venta de token : node build/sell-token.js <token_address> <sell_amount> [account_name] [slippage_basis_points]

• Lista de cuentas : node build/list-accounts.js

• Obtener el saldo de la cuenta : node build/get-token-balance.js <account_name> [token_address]

Notas importantes

• Seguridad : Los pares de claves se almacenan sin cifrar en la carpeta .keys . Asegúrese de proteger esta carpeta adecuadamente.

• Comisiones : Todas las transacciones en Solana requieren SOL para cubrir las comisiones. Asegúrese de tener suficiente SOL en sus cuentas.

• Deslizamiento : La tolerancia de deslizamiento predeterminada es del 1 % (100 puntos básicos). Puede ajustarla para cada transacción.

• Imágenes : Al crear tokens con imágenes, debe proporcionar la ruta de acceso local a la imagen. No se admiten URL remotas.

Desarrollo

Estructura del proyecto

• src/index.ts : Punto de entrada principal del servidor MCP

• src/get-token-info.ts : Recuperación de información del token

• src/create-token.ts : Funcionalidad de creación de tokens

• src/buy-token.ts : Funcionalidad de compra de tokens

• src/sell-token.ts : Funcionalidad de venta de tokens

• src/list-accounts.ts : Funcionalidad de listado de cuentas

• src/get-token-balance.ts : Consulta del saldo de la cuenta

• src/utils.ts : Funciones de utilidad compartidas

• convert-key.js : Utilidad para convertir una clave privada base58 en un archivo JSON de par de claves

Edificio