MCP Helius

此仓库包含一个模型上下文协议 (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: 按 mint 或所有者获取代币帐户

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: 获取有关当前 epoch 的信息
• helius_get_epoch_schedule: 获取 epoch 计划
• helius_get_leader_schedule: 获取 epoch 的领导者计划
• 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 Desktop 应用程序

安装

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": [
        "@dcspark/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. 检查钱包余额：

   Solana 钱包地址 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 的余额是多少？
   

2. 获取当前区块高度：

   Solana 上的当前区块高度是多少？
   

3. 获取有关 NFT 的信息：

   钱包地址 5YNmS1R9nNSCDzb5a7mMJ1dwK9uHeAAF4CmPEwKgVWr8 拥有哪些 NFT？
   

Claude 将使用 MCP 服务器通过 Helius 直接从 Solana 区块链获取此信息。

开发

添加新工具

要向 MCP 服务器添加新工具：

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

构建

npm run build

许可证

MIT