MCP Helius

MCP Helius

Este repositório contém um servidor Model Context Protocol (MCP) que fornece ao Claude acesso a dados da blockchain Solana por meio da API Helius. O servidor permite que o Claude execute operações como verificar saldos de carteiras, obter informações da blockchain e interagir com tokens e NFTs na blockchain Solana.

Visão Geral

O servidor MCP expõe as seguintes ferramentas ao Claude:

Operações Básicas de Blockchain

• helius_get_balance: Obter o saldo de um endereço de carteira Solana
• helius_get_block_height: Obter a altura atual do bloco da blockchain Solana
• helius_get_slot: Obter o slot atual da blockchain Solana
• helius_get_latest_blockhash: Obter o blockhash mais recente da blockchain Solana
• helius_get_transaction: Obter uma transação pela sua assinatura
• helius_get_account_info: Obter informações da conta para um endereço Solana
• helius_get_signatures_for_address: Obter assinaturas de transações para um endereço Solana
• helius_get_multiple_accounts: Obter informações sobre várias contas Solana
• helius_get_program_accounts: Obter todas as contas pertencentes a um programa

Operações de Token

• helius_get_token_accounts_by_owner: Obter contas de token pertencentes a um endereço Solana
• helius_get_token_supply: Obter o fornecimento de um token
• helius_get_token_account_balance: Obter o saldo de uma conta de token
• helius_get_token_accounts: Obter contas de token por mint ou proprietário

NFTs e Ativos Digitais

• helius_get_asset: Obter detalhes de um ativo digital pelo seu ID
• helius_get_rwa_asset: Obter detalhes de um ativo do mundo real pelo seu ID
• helius_get_asset_batch: Obter detalhes de vários ativos pelos seus IDs
• helius_get_asset_proof: Obter prova para um ativo digital
• helius_get_assets_by_group: Obter ativos por chave e valor de grupo
• helius_get_assets_by_owner: Obter ativos pertencentes a um endereço específico
• helius_get_assets_by_creator: Obter ativos criados por um endereço específico
• helius_get_assets_by_authority: Obter ativos por endereço de autoridade
• helius_search_assets: Pesquisar ativos usando vários filtros (ownerAddress, creatorAddress, compressed, etc.)
• helius_get_signatures_for_asset: Obter assinaturas associadas a um ativo
• helius_get_nft_editions: Obter edições de NFT para uma edição mestre

Informações do Sistema Blockchain

• helius_get_minimum_balance_for_rent_exemption: Obter o saldo mínimo necessário para isenção de aluguel
• helius_get_inflation_reward: Obter recompensas de inflação para uma lista de endereços
• helius_get_epoch_info: Obter informações sobre a época atual
• helius_get_epoch_schedule: Obter o cronograma de épocas
• helius_get_leader_schedule: Obter o cronograma de líderes para uma época
• helius_get_recent_performance_samples: Obter amostras de desempenho recentes
• helius_get_version: Obter a versão do nó Solana

Métodos de Transação e Taxas

• helius_get_priority_fee_estimate: Obter estimativa de taxa prioritária para uma transação
• helius_poll_transaction_confirmation: Verificar o status de confirmação de transação
• helius_send_jito_bundle: Enviar um pacote de transações para Jito
• helius_get_bundle_statuses: Obter status de pacotes Jito
• helius_get_fee_for_message: Obter a taxa para uma mensagem serializada
• helius_execute_jupiter_swap: Executar uma troca de token usando Jupiter

Pré-requisitos

• Node.js (v16 ou superior)
• Uma chave de API Helius (obtenha uma em https://dev.helius.xyz/)
• Aplicativo Claude Desktop

Instalação

1. Clone este repositório:

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

2. Instale as dependências:

   npm ci
   

3. Compile o projeto:

   npm run build
   

Configuração

Configurar o Claude Desktop

Para configurar o Claude Desktop para usar este servidor MCP:

1. Abra o Claude Desktop

2. Navegue até o arquivo de configuração do 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. Adicione a configuração do servidor MCP:

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

Executando Localmente

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

Você também pode executar diretamente usando npx:

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

Uso

Depois de configurado, reinicie o Claude Desktop. O Claude agora terá acesso às ferramentas da blockchain Solana. Você pode pedir ao Claude para:

1. Verificar o saldo de uma carteira:

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

2. Obter a altura atual do bloco:

   What's the current block height on Solana?
   

3. Obter informações sobre NFTs:

   What NFTs does the wallet address 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 own?
   

O Claude usará o servidor MCP para buscar essas informações diretamente da blockchain Solana por meio da Helius.

Desenvolvimento

Adicionando Novas Ferramentas

Para adicionar novas ferramentas ao servidor MCP:

1. Defina a ferramenta em src/tools.ts
2. Crie uma função de manipulador no arquivo de manipulador apropriado
3. Adicione o manipulador ao objeto handlers em src/tools.ts

Compilação

npm run build

Licença

MIT