面向智能体的 Helius

Helius MCP 服务器：工具

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

Helius MCP 服务器向任何 MCP 客户端开放 Helius 和 Solana。

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

当给定工作流中的每次 API 调用都要重复这一过程时，交互就会变得缓慢、脆弱且容易出错，因为每条命令都需要启动一个 shell 实例。

有了 MCP，这些问题都不复存在。

智能体以结构化工具调用的方式调用 getBalance，并收到类型化响应。不需要 shell。不需要 curl。也不需要解析输出——开箱即用。

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

Helius MCP 服务器提供以下工具：

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

快速安装

要通过 Claude Code 添加 Helius MCP 服务器，请运行：

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 密钥，即可开始发布。

对于新用户，你的智能体可以自主为你创建账户：它会生成密钥对，你为其充值，然后调用 agenticSignup 购买所需套餐，起价仅为 1 美元。 

Helius 技能：大脑

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

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

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

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

构建

构建技能适用于 Solana 核心开发。它会为 DAS、Sender、WebSockets、LaserStream、webhook、增强型交易、钱包分析和用户引导选择正确的工具。这是使用 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 插件时，技能会自动安装。独立技能可以作为智能体技能安装——它们会自动调用，无需斜杠命令：

# 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 插件：整合套件

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

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

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

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

快速安装

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

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

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

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

实际使用效果

安装插件后，你可以从一条提示词直接生成可运行的应用。例如：

“帮我构建一个税务报告 CLI，让我可以使用 Toly 的钱包地址 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY 获取他的链上活动。先从上个月（2 月）开始，输出一份列出他所有应税事件的 CSV 文件。确保它适用于任意钱包和任意时间范围。”

Claude 一次就完成了：   

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

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

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

在这个示例中，我们安装了 Helius Claude Code 插件，并让 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

# Fund wallet with ~0.001 SOL + 1 USDC
helius signup --json             # Create account, 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 更进一步，专为超低延迟交易提交而优化。

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

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 中的相同模式（即批处理、分页、Sender、重试策略和常见陷阱），请参阅 Rust 最佳实践。 

开始使用

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

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

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