MCP Helius

MCP Helius

此仓库包含一个 Model Context Protocol（MCP）服务，通过 Helius API 为 Claude 提供 Solana 区块链数据访问。该服务使 Claude 能够执行检查钱包余额、获取区块链信息以及与 Solana 区块链上的代币和 NFT 交互等操作。

概述

此 MCP 服务向 Claude 提供以下工具：

基础区块链操作

• helius_get_balance：获取 Solana 钱包地址的余额
• helius_get_block_height：获取 Solana 区块链的当前区块高度
• helius_get_slot：获取 Solana 区块链的当前插槽
• helius_get_latest_blockhash：获取 Solana 区块链的最新区块哈希
• helius_get_transaction：通过签名获取交易
• helius_get_account_info：获取 Solana 地址的账户信息
• helius_get_signatures_for_address：获取 Solana 地址的交易签名
• helius_get_multiple_accounts：获取多个 Solana 账户的信息
• helius_get_program_accounts：获取程序拥有的所有账户

代币操作

• helius_get_token_accounts_by_owner：获取 Solana 地址拥有的代币账户
• helius_get_token_supply：获取代币供应量
• helius_get_token_account_balance：获取代币账户的余额
• helius_get_token_accounts：按铸币地址或所有者获取代币账户

NFT 和数字资产

• helius_get_asset：通过 ID 获取数字资产详情
• helius_get_rwa_asset：通过 ID 获取现实世界资产详情
• helius_get_asset_batch：通过 ID 获取多个资产的详情
• helius_get_asset_proof：获取数字资产的证明
• helius_get_assets_by_group：按群组键和值获取资产
• helius_get_assets_by_owner：获取特定地址拥有的资产
• helius_get_assets_by_creator：获取特定地址创建的资产
• helius_get_assets_by_authority：按权限地址获取资产
• helius_search_assets：使用各种筛选条件搜索资产（ownerAddress、creatorAddress、compressed 等）
• helius_get_signatures_for_asset：获取与资产关联的签名
• helius_get_nft_editions：获取主版本对应的 NFT 版本

区块链系统信息

• helius_get_minimum_balance_for_rent_exemption：获取免租金所需的最低余额
• helius_get_inflation_reward：获取地址列表的通胀奖励
• helius_get_epoch_info：获取当前纪元的信息
• helius_get_epoch_schedule：获取纪元计划
• helius_get_leader_schedule：获取某个纪元的领导者计划
• helius_get_recent_performance_samples：获取近期性能样本
• helius_get_version：获取 Solana 节点的版本

交易和费用方法

• helius_get_priority_fee_estimate：获取交易的优先费估算
• helius_poll_transaction_confirmation：轮询交易确认状态
• helius_send_jito_bundle：向 Jito 发送一组交易
• helius_get_bundle_statuses：获取 Jito 交易组的状态
• helius_get_fee_for_message：获取序列化消息的费用
• helius_execute_jupiter_swap：使用 Jupiter 执行代币兑换

先决条件

• Node.js（v16 或更高版本）
• Helius API 密钥（在 https://dev.helius.xyz/ 获取）
• Claude 桌面应用

安装

1. 克隆此仓库：

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

2. 安装依赖：

   npm ci
   

3. 构建项目：

   npm run build
   

配置

配置 Claude Desktop

配置 Claude Desktop 使用此 MCP 服务：

1. 打开 Claude Desktop

2. 找到 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. 添加 MCP 服务配置：

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

本地运行

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

你也可以直接使用 npx 运行：

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

用法

配置完成后，重新启动 Claude Desktop。现在 Claude 就可以使用 Solana 区块链工具了。你可以让 Claude：

1. 查询钱包余额：

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

2. 获取当前区块高度：

   What's the current block height on Solana?
   

3. 获取 NFT 信息：

   What NFTs does the wallet address 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 own?
   

Claude 会通过 MCP 服务，经由 Helius 直接从 Solana 区块链获取这些信息。

开发

添加新工具

要向 MCP 服务添加新工具：

1. 在 src/tools.ts 中定义工具
2. 在相应的处理程序文件中创建处理函数
3. 将处理函数添加到 src/tools.ts 中的 handlers 对象

构建

npm run build

许可证

MIT