📌Overview

Purpose: To provide a server that connects Claude to the Solana blockchain data via the Helius API, enabling various blockchain-related operations.

Overview: The MCP server enhances Claude's capabilities by allowing real-time interactions with the Solana blockchain. Users can perform actions such as checking wallet balances, retrieving transaction information, managing tokens and NFTs, and accessing essential blockchain metrics.

Key Features:

Basic Blockchain Operations: Access to fundamental functions such as wallet balance check, transaction retrieval, and block information which facilitate efficient management of blockchain data.
Token Operations: Tools for managing token accounts, including supply checks and balance inquiries, ensuring seamless interactions with digital assets.
NFT and Digital Assets Management: Comprehensive features for retrieving details about NFTs and other digital assets, allowing users to manage and inquire about their digital collections.
Blockchain System Information: Access to various system metrics like epoch schedules, inflation rewards, and version information to keep users informed about network status.
Transaction and Fee Methods: Tools for estimating fees and handling transactions, including the ability to send bundled transactions, enhancing operational efficiency on the blockchain.

MCP Helius

This repository contains a Model Context Protocol (MCP) server that provides Claude with access to Solana blockchain data via the Helius API. The server enables operations such as checking wallet balances, retrieving blockchain information, and interacting with tokens and NFTs on the Solana blockchain.

Overview

The MCP server exposes the following tools to Claude:

Basic Blockchain Operations

helius_get_balance: Get the balance of a Solana wallet address.
helius_get_block_height: Get the current block height of the Solana blockchain.
helius_get_slot: Get the current slot of the Solana blockchain.
helius_get_latest_blockhash: Get the latest blockhash from the Solana blockchain.
helius_get_transaction: Get a transaction by its signature.
helius_get_account_info: Get account information for a Solana address.
helius_get_signatures_for_address: Get transaction signatures for a Solana address.
helius_get_multiple_accounts: Get information about multiple Solana accounts.
helius_get_program_accounts: Get all accounts owned by a program.

Token Operations

helius_get_token_accounts_by_owner: Get token accounts owned by a Solana address.
helius_get_token_supply: Get the supply of a token.
helius_get_token_account_balance: Get the balance of a token account.
helius_get_token_accounts: Get token accounts by mint or owner.

NFT and Digital Assets

helius_get_asset: Get details of a digital asset by its ID.
helius_get_assets_by_owner: Get assets owned by a specific address.
helius_search_assets: Search for assets using various filters.

Blockchain System Information

helius_get_epoch_info: Get information about the current epoch.
helius_get_version: Get the version of the Solana node.

Transaction and Fee Methods

helius_get_priority_fee_estimate: Get priority fee estimate for a transaction.
helius_poll_transaction_confirmation: Poll for transaction confirmation status.
helius_send_jito_bundle: Send a bundle of transactions to Jito.

Prerequisites

Node.js (v16 or higher)
A Helius API key (obtain from Helius)
Claude Desktop application

Installation

Clone the repository:

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

Install dependencies:
```
npm ci
```
Build the project:
```
npm run build
```

Configuration

Configure Claude Desktop

Open Claude Desktop.
Navigate to the Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Add the MCP server configuration:

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

Running Locally

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

You can also run directly using npx:

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

Usage

Once configured, restart Claude Desktop. You can ask Claude to perform actions such as:

Check a wallet balance:

What's the balance of the Solana wallet address [ADDRESS]?

Get the current block height:

What's the current block height on Solana?

Get information about NFTs:

What NFTs does the wallet address [ADDRESS] own?

Development

Adding New Tools

To add new tools to the MCP server:

Define the tool in src/tools.ts.
Create a handler function in the appropriate handler file.
Add the handler to the handlers object in src/tools.ts.

Building

npm run build

License

MIT