MCP Helius

Accede a datos de la blockchain de Solana usando la API de Helius.

GitHub
14
Prueba este MCPPatrocinado

Documentación

MCP Helius

Este repositorio contiene un servidor de Model Context Protocol (MCP) que proporciona a Claude acceso a datos de la blockchain de Solana a través de la API de Helius. El servidor permite a Claude realizar operaciones como consultar saldos de billeteras, obtener información de la blockchain e interactuar con tokens y NFTs en la blockchain de Solana.

Descripción general

El servidor MCP expone las siguientes herramientas a Claude:

Operaciones básicas de blockchain

  • helius_get_balance: Obtener el saldo de una dirección de billetera de Solana
  • helius_get_block_height: Obtener la altura de bloque actual de la blockchain de Solana
  • helius_get_slot: Obtener el slot actual de la blockchain de Solana
  • helius_get_latest_blockhash: Obtener el blockhash más reciente de la blockchain de Solana
  • helius_get_transaction: Obtener una transacción por su firma
  • helius_get_account_info: Obtener información de cuenta para una dirección de Solana
  • helius_get_signatures_for_address: Obtener firmas de transacciones para una dirección de Solana
  • helius_get_multiple_accounts: Obtener información sobre múltiples cuentas de Solana
  • helius_get_program_accounts: Obtener todas las cuentas propiedad de un programa

Operaciones con tokens

  • helius_get_token_accounts_by_owner: Obtener cuentas de token propiedad de una dirección de Solana
  • helius_get_token_supply: Obtener el suministro de un token
  • helius_get_token_account_balance: Obtener el saldo de una cuenta de token
  • helius_get_token_accounts: Obtener cuentas de token por mint o propietario

NFTs y activos digitales

  • helius_get_asset: Obtener detalles de un activo digital por su ID
  • helius_get_rwa_asset: Obtener detalles de un activo del mundo real por su ID
  • helius_get_asset_batch: Obtener detalles de múltiples activos por sus IDs
  • helius_get_asset_proof: Obtener prueba de un activo digital
  • helius_get_assets_by_group: Obtener activos por clave de grupo y valor
  • helius_get_assets_by_owner: Obtener activos propiedad de una dirección específica
  • helius_get_assets_by_creator: Obtener activos creados por una dirección específica
  • helius_get_assets_by_authority: Obtener activos por dirección de autoridad
  • helius_search_assets: Buscar activos usando varios filtros (ownerAddress, creatorAddress, compressed, etc.)
  • helius_get_signatures_for_asset: Obtener firmas asociadas con un activo
  • helius_get_nft_editions: Obtener ediciones de NFT para una edición maestra

Información del sistema blockchain

  • helius_get_minimum_balance_for_rent_exemption: Obtener el saldo mínimo requerido para exención de alquiler
  • helius_get_inflation_reward: Obtener recompensas por inflación para una lista de direcciones
  • helius_get_epoch_info: Obtener información sobre la época actual
  • helius_get_epoch_schedule: Obtener el calendario de épocas
  • helius_get_leader_schedule: Obtener el calendario de líderes para una época
  • helius_get_recent_performance_samples: Obtener muestras de rendimiento recientes
  • helius_get_version: Obtener la versión del nodo de Solana

Métodos de transacción y tarifas

  • helius_get_priority_fee_estimate: Obtener estimación de tarifa prioritaria para una transacción
  • helius_poll_transaction_confirmation: Consultar el estado de confirmación de una transacción
  • helius_send_jito_bundle: Enviar un lote de transacciones a Jito
  • helius_get_bundle_statuses: Obtener estados de los lotes de Jito
  • helius_get_fee_for_message: Obtener la tarifa para un mensaje serializado
  • helius_execute_jupiter_swap: Ejecutar un intercambio de tokens usando Jupiter

Requisitos previos

  • Node.js (v16 o superior)
  • Una clave de API de Helius (obtén una en https://dev.helius.xyz/)
  • Aplicación Claude Desktop

Instalación

  1. Clona este repositorio:

    git clone https://github.com/dcSpark/mcp-server-helius.git
cd mcp-server-helius

  2. Instala las dependencias:

    npm ci

  3. Compila el proyecto:

    npm run build

Configuración

Configurar Claude Desktop

Para configurar Claude Desktop para usar este servidor MCP:

  1. Abre Claude Desktop

  2. Navega al archivo de configuración de Claude Desktop:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  3. Agrega la configuración del servidor MCP:

{
  "mcpServers": {
    "mcp-server-helius": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-dockmaster/mcp-server-helius"
      ],
      "env": {
        "HELIUS_API_KEY": "your-helius-api-key"
      }
    }
  }
}

Ejecución local

HELIUS_API_KEY=your-helius-api-key node build/index.js

También puedes ejecutarlo directamente usando npx:

HELIUS_API_KEY=your-helius-api-key npx @dcspark/mcp-server-helius

Uso

Una vez configurado, reinicia Claude Desktop. Claude ahora tendrá acceso a las herramientas de la blockchain de Solana. Puedes pedirle a Claude que:

  1. Consulte el saldo de una billetera:

    What's the balance of the Solana wallet address 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8?

  2. Obtenga la altura de bloque actual:

    What's the current block height on Solana?

  3. Obtenga información sobre NFTs:

    What NFTs does the wallet address 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 own?

Claude usará el servidor MCP para obtener esta información directamente de la blockchain de Solana a través de Helius.

Desarrollo

Agregar nuevas herramientas

Para agregar nuevas herramientas al servidor MCP:

  1. Define la herramienta en src/tools.ts
  2. Crea una función de manejo en el archivo de manejadores correspondiente
  3. Agrega el manejador al objeto handlers en src/tools.ts

Compilación

npm run build

Licencia

MIT