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: 通过铸币或所有者获取代币账户

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 桌面应用程序

要配置 Claude 桌面应用程序以使用此 MCP 服务器：

1. 打开 Claude 桌面应用程序

2. 导航到 Claude 桌面配置文件：

   • 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 桌面应用程序。Claude 现在可以访问 Solana 区块链工具。您可以要求 Claude：

1. 检查钱包余额：

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

2. 获取当前区块高度：

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

3. 获取 NFT 信息：

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

Claude 将通过 MCP 服务器从 Helius 直接获取这些信息。

开发

添加新工具

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

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

构建

npm run build

许可证

MIT