Helius 智能体工具

Helius MCP Server：工具

模型上下文协议 (MCP) 是 Anthropic 推出的一项开源标准，让 AI 模型能够安全连接外部数据源、工具和 API。它以通用的标准化接口取代自定义集成。 

Helius MCP Server 可将 Helius 乃至 Solana 接入任何 MCP 客户端。

如果没有 MCP，智能体在查询钱包余额时，必须打开 shell、构造一条 curl 命令、发送命令、解析 JSON 输出，然后祈祷端点和参数都没有出错。

把这一过程乘以特定工作流中的每次 API 调用，你最终得到的将是缓慢、脆弱且容易出错的交互，因为每条命令都需要创建一个 shell 实例。

有了 MCP，这些步骤都不再需要。

智能体以结构化工具调用的方式调用 getBalance，并收到类型化响应。无需 shell。无需 curl。无需解析输出，一切直接可用。

parseTransaction、getAssetsByOwner、createWebhook 以及其他 60 多种工具也是如此。智能体现在可以使用正确的参数直接调用 Helius，并获得结构化数据。 

Helius MCP server 提供以下工具：

• **自主注册：**创建账户、获取 API 密钥、升级等
• **实时区块链数据：**RPC、DAS API、ZK Compression 等
• **数据流：**WebSockets（标准版和增强版）、LaserStream gRPC（shred 级延迟）
• **发送交易：**优先费 API、SPL 转账和 Sender
• Webhook：创建、更新和删除事件驱动通知
• **钱包和历史记录：**余额、转账、交易解析、钱包身份识别和资金分析
• **Solana 知识：**SIMD、Agave 和 Firedancer 源代码参考、Helius 博客内容以及 Solana 官方文档搜索

快速安装

要在 Claude Code 中添加 Helius MCP Server，请运行：

claude mcp add helius npx helius-mcp@latest

对于 Codex，请运行：

codex mcp add helius -- npx helius-mcp@latest

对于 Cursor、VS Code 或类似工具，请将以下内容添加到 MCP 配置中：

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

然后使用 setHeliusApiKey 工具或环境变量（例如 HELIUS_API_KEY）设置 API 密钥，即可开始发布产品。

对于新用户，你的智能体可以自主创建账户。它会生成密钥对，并使用你的电子邮件地址和姓名调用 signup。随后，你可以通过付款链接购买所需套餐，也可以为密钥对充值以启用自动付款。 

Helius Skills：大脑

MCP 让智能体可以使用 60 多种工具。但只有访问权限还不够——拥有工具目录的智能体，就像打开了多个文档标签页却毫无经验的开发者。它可以调用工具，却不知道该选择哪种工具、如何针对特定任务组合工具，也不知道应避免哪些错误。 

技能就是大脑。它们是一组专家级指令，包括精心设计的提示词、路由逻辑、参考文件和规则，能够教会智能体如何成为 Solana 开发专家。

加载技能后，智能体会知道查询 NFT 时 searchAssets 比 getProgramAccounts 更合适，优先费应通过 getPriorityFeeEstimates 动态获取，而交易应通过 Sender 发送以获得最高上链率。技能可以为智能体提供领域专业知识。

今天，我们推出四项主要的 Helius Skills：

Build

Build 技能面向 Solana 核心开发。它可以为 DAS、Sender、WebSockets、LaserStream、Webhook、Enhanced Transactions、钱包分析和用户引导选择正确的工具。使用 Helius 在 Solana 上构建任何应用时，这都是默认技能。 

DFlow

DFlow 技能用于构建交易应用。它将 DFlow API（即现货兑换、预测市场、实时数据流和 Proof KYC）与 Helius 基础设施结合，用于提交交易、优化费用和执行链上监控。 

Phantom

Phantom 技能用于通过 Phantom Connect SDK 构建前端应用。它涵盖钱包连接、代币门控、NFT 铸造、加密货币支付、投资组合展示和安全的前端架构。

SVM

SVM 技能让智能体能够理解 Solana 协议内部机制。通过从 Helius 博客、SIMD 以及 Agave/Firedancer 源代码中获取实时内容，探索 sBPF 字节码的执行方式、Alpenglow 设计考量、验证者经济模型等内容。无需 API 密钥。

技能的工作原理

技能不依赖特定模型。每项技能都附带预构建的系统提示词变体，可在所有平台上使用，而不仅限于 Claude。

OpenAI API 请使用 openai.developer.md，Claude API 请使用 claude.system.md，Cursor Rules、ChatGPT 自定义指令或任何其他工具请使用 full.md。有关特定平台的设置，请参阅技能概览。

使用 Helius Claude Code Plugin 时会自动安装这些技能。独立技能可以作为 Agent Skills 安装，并自动调用，无需斜杠命令：

# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

借助这些技能，智能体几乎可以构建任何 Solana 应用，从交易前端、预测市场应用到稳定币支付处理程序，并且从一开始就采用正确的模式。

Helius Claude Code Plugin：整合套件

MCP 提供工具，而技能充当大脑。Helius Claude Code Plugin 则是整合套件，只需安装一次，即可将所有组件连接起来。开箱即用。

该插件整合了 Helius MCP、DFlow MCP、全部四项技能，以及每种 Helius 产品的深度参考文件。

无需手动配置 MCP。无需单独设置技能。

只需安装一次，你的智能体便能在单个会话中获得结构化的区块链访问能力和专业的 Solana 知识。

快速安装

以下是从 Claude Code 市场安装 Helius Plugin 的方法：

/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

就是这么简单。该插件会自动启动两个 MCP server，目前提供四条斜杠命令：

API 密钥的设置方式与独立 MCP 相同：使用现有密钥、启用自主注册，或使用 Helius CLI。 

实际使用效果

安装插件后，只需输入一条提示词，即可获得可运行的应用。例如：

“为我构建一个税务报告 CLI，让我可以使用 Toly 的钱包地址 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY 获取他的链上活动。先处理上个月（2 月）的数据，并输出一份 CSV 文件，列出他的所有应税事件。它需要支持任意钱包和任意时间范围。”

Claude 一次就完成了：   

/helius:build 技能会自动介入，并正确建议使用 getTransactionsByAddress，结合分页和时间戳筛选，根据 Toly 最近的活动返回完整解析的交易历史记录。

无需手动选择工具，也无需中途追加提示。智能体会读取正确的参考文件、调用正确的 MCP 工具，并生成一个支持任意钱包和任意日期范围的可用 CLI。

当然，智能体也能构建更复杂的应用，例如交易机器人：

在这个示例中，我们安装了 Helius Claude Code Plugin，并让 Claude 构建一个实时跟踪 PumpFun 代币的交易机器人，通过 LaserStream 以流式方式获取代币创建和交易数据。

我们还要求它显示市场数据并提供基础图表功能，以便进行模拟交易。仅此而已。Claude 构建了这个交易机器人，具备实时代币数据流和交易功能，整个过程不到 10 分钟。

这就是为智能体提供工具与赋予它专业能力之间的区别。

Helius CLI

Helius CLI 是功能完备的命令行界面，提供 95 条以上的 CLI 命令，涵盖账户管理、查询 Solana、发送交易、管理 webhook、实时数据流、质押、ZK Compression 等功能。

对于 AI 驱动的工作流，我们推荐使用 MCP，因为结构化工具调用优于创建 shell 实例并解析输出。不过，对于 shell 脚本、构建 CI/CD 流水线，或 MCP 不可用的环境，CLI 才是正确选择。每条命令都支持 --json 选项以输出机器可读的数据，并返回结构化退出代码，让自动化程序能够以编程方式处理错误。

快速安装

对于新用户，流程很简单：

# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Signup requires a valid email and name
helius signup --email you@example.com --first-name Jane --last-name Doe
# Pay via the printed link with any wallet, then:
helius signup --resume           # Finalize and get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

现有用户只需运行：

helius config set-api-key YOUR_API_KEY

针对智能体优化的 SDK

对于以编程方式构建应用的智能体，我们发布了针对智能体优化的 TypeScript SDK 和 Rust SDK 文档。

这些页面介绍常见智能体工作流的推荐模式，包括通过 Sender 发送交易、批处理、实时数据、分页和错误处理。 

TypeScript SDK

Helius TypeScript SDK 为每次 Helius API 调用提供类型安全的方法。对智能体而言，关键在于 Helius 专用方法可以将多步骤 Solana 工作流简化为单次调用。 

例如，getTransactionsForAddress 取代了先获取签名、再获取交易这种过时的标准两步模式。只需一次调用，即可支持服务端筛选、时间范围和代币账户： 

import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

同样，sendSmartTransaction 会自动处理模拟、计算单元估算、优先费和确认。

sendTransactionWithSender 在此基础上更进一步，专为超低延迟交易提交而优化。

请参阅 TypeScript 最佳实践，了解批处理、分页、通过 webhook 和 WebSockets 获取实时数据、增量获取账户、错误处理，以及智能体应避免的常见陷阱。 

Rust SDK

Helius Rust SDK 提供具有相同 Helius 方法的异步 Rust 绑定，非常适合高性能智能体工作流：

use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

Rust SDK 还提供类型化错误变体（例如 HeliusError::RateLimitExceeded），因此智能体可以直接匹配错误，而无需解析字符串。

请参阅 Rust 最佳实践，了解 Rust 中的相同模式（即批处理、分页、Sender、重试策略和常见陷阱）。 

开始使用

Helius 为智能体提供最全面的工具包，帮助它们在 Solana 上构建可用于生产环境的应用。你可以通过以下方式开始：

• 最快路径：安装 Claude Code Plugin 
• 任意 MCP 客户端：将 Helius MCP Server 添加到 Claude Desktop、Cursor、VS Code、Codex 或 Windsurf
• Shell 自动化：安装 Helius CLI，用于脚本和 CI/CD
• API 集成：将技能系统提示词添加到 OpenAI API、Claude API 或 ChatGPT

阅读我们的文档，探索 GitHub 代码库，提出技能集成方案。如有任何问题，请联系我们的支持团队。