Helius MCP 服务器 - Helius Docs

Helius MCP 服务器通过10 个公共工具为 AI 工具提供直接访问 Helius API 的能力 — 包括涵盖所有 Helius 和 Solana 功能的 9 个路由域工具，以及用于分页大型响应的 expandResult。

9 个路由工具

按域分组的工具（heliusWallet、heliusAsset、heliusTransaction，…）—每个 Helius 操作都可以通过它们之一访问

账户注册

从你的 AI 工具创建一个 Helius 账号 — 可通过托管链接支付或使用本地密钥对自动支付 USDC

实时数据

直接从你的 AI 工具订阅增强的 WebSockets 和 LaserStream gRPC

任意 MCP 客户端

适用于 Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Codex 和任何 MCP 兼容工具

什么是 MCP？

模型上下文协议 (MCP) 是由 Anthropic 引入的开源标准，允许 AI 模型安全连接到外部数据源、工具和 API。它使用一种客户端-服务器架构，主机（如 Claude）连接到一个 MCP 服务器，使 AI 能够通过一个通用、标准化的接口查询数据库、调用 API 或执行操作。 这对于 Helius 的重要性： MCP 让 Claude 可以直接访问实时 Solana 数据和 Helius 基础设施 — 余额、资产元数据、解析交易、webhook 管理、流媒体等。没有它，Claude 必须猜测 API 响应或不断发送 curl 请求以获取上下文。MCP 允许 Claude 通过 Helius 使用结构化工具调用真实与 Solana 交互。

Helius 文档网站 helius.dev/docs 也公开了一个由 Mintlify 自动生成的独立 MCP 服务器。该服务器仅限于文档搜索。这里记录的 helius-mcp 是涵盖所有 Helius 和 Solana 功能的综合服务器。

快速开始

添加 MCP 服务器

claude mcp add helius npx helius-mcp@latest

或添加到你的 MCP 主机配置中（Claude Desktop、Cursor、Windsurf、VS Code 等）：

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

配置你的 API 密钥

如果你已有密钥：

export HELIUS_API_KEY=YOUR_API_KEY

或通过在 heliusAccount 上调用 setHeliusApiKey 操作在 Claude 内设置。API 密钥按以下顺序解析：

会话中的 setHeliusApiKey 操作调用
HELIUS_API_KEY 环境变量
~/.helius/config.json （通过 Helius CLI 设置）

如果你需要新的账户： 请参见下面的注册。

开始使用工具

用简单的英语提出问题 — 工具和操作将自动选择：

“这个钱包拥有哪些 NFT？”
“解析此交易：5abc...”
“获取 Gh9ZwEm... 的余额”
“发送 1 SOL 给 7xKp...”
“为此地址创建一个 webhook”

连接到 Helius MCP 服务器

运行以下命令：

claude mcp add helius npx helius-mcp@latest

或添加到项目的 .mcp.json：

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

验证：

claude mcp list

想要技能和MCP一步到位？安装Helius插件。将其作为两个独立命令运行：

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

打开Settings > Developer > Edit Config并添加服务器：

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

重新启动Claude Desktop以应用更改。

打开命令面板(Cmd/Ctrl + Shift + P)，搜索MCP: Add Server，输入：

名称： helius
命令： npx helius-mcp@latest

或添加到您的项目的.cursor/mcp.json：

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

在项目根目录中创建一个.vscode/mcp.json文件：

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

需要启用MCP支持的GitHub Copilot扩展。

打开命令面板(Cmd/Ctrl + Shift + P)，搜索Configure MCP Servers，添加：

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

运行以下命令：

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

或添加到您的~/.codex/config.toml（或项目范围的.codex/config.toml）：

[mcp_servers.helius]
command = "npx"
args = ["helius-mcp@latest"]

验证：

codex mcp list

公开工具界面

Helius MCP 公开10个公共工具：9个路由域工具加上expandResult。每个Helius和Solana操作都可以作为适当路由工具上的一个action参数访问。

工具	范围
`heliusAccount`	账户设置、身份验证、计划、计费
`heliusWallet`	钱包余额、持有、历史记录、身份
`heliusAsset`	资产、NFT、收藏品、代币持有者
`heliusTransaction`	交易解析和钱包交易历史
`heliusChain`	链状态、代币账户、区块、网络状态、程序账户
`heliusStreaming`	Webhook CRUD 和订阅配置（WebSockets，LaserStream）
`heliusKnowledge`	文档、指南、定价、故障排除、来源、博客、SIMDs
`heliusWrite`	转账—SOL和SPL代币
`heliusCompression`	压缩NFT的Merkle证明
`expandResult`	通过`resultId`扩展摘要优先输出

完整工具目录

每个操作按路由工具分组，具有调用形状详细信息和expandResult使用方法

路由工具调用形状

9个路由工具中的每一个都有一个通用的形状：

action — 要运行的Helius操作名称，例如getBalance或createWebhook
域特定参数 — 例如address、signatures或webhookURL
可选的detail — summary、standard或full
遥测字段 — _feedback、_feedbackTool、_model

示例调用：

{
  "name": "heliusWallet",
  "arguments": {
    "action": "getBalance",
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "_feedback": "initial balance check",
    "_feedbackTool": "heliusWallet.getBalance",
    "_model": "your-model-id"
  }
}

摘要优先响应和`expandResult`

繁重的响应是摘要优先的。路由工具返回简洁的摘要加上resultId，当完整响应较大或请求detail: "summary"时适用。使用 expandResult搭配该resultId以按需提取特定部分、范围、页面或连续切片。这使得探索性查询的代币使用保持较低，同时仍然允许代理深入完整的有效负载。

注册

通过托管支付链接或通过本地密钥对直接支付USDC，从您的AI工具创建一个Helius账户。注册流程通过heliusAccount路由工具运行：

生成密钥对

AI调用heliusAccount 与 action: "generateKeypair" — 创建一个Solana钱包并返回地址。

创建支付意图

AI调用heliusAccount 与 action: "signup" 和 mode: "link" — 返回一个paymentUrl（例如 https://dashboard.helius.dev/pay/<id>）用户可以使用任何钱包支付。或者传递mode: "autopay"自行从本地密钥对发送USDC（钱包必须持有约0.001 SOL + 计划金额的USDC）。

付款后继续

通过链接付款后，AI调用heliusAccount 与 action: "signup" 和 mode: "resume" — 轮询支付意图，最终确定账户配置，并自动配置API密钥。

**联系信息：**每个新注册 — 包括代理计划 — 需要email、firstName和lastName。upgradePlan也需要相同的信息。

或者通过Helius CLI从终端执行相同操作：

npx helius-cli@latest keygen
npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe   # Print hosted payment link
# (pay in browser, then:)
npx helius-cli@latest signup --resume         # Finalize account
# Or autopay from the local keypair:
npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

网络配置

MCP服务器默认为mainnet-beta。通过环境变量切换到devnet：

export HELIUS_NETWORK=devnet

或者在会话中调用setNetwork操作上的heliusAccount。

系统提示

helius-mcp包装有预构建的系统提示，这些提示教AI模型如何有效地使用Helius工具。它们位于system-prompts/：

system-prompts/
├── helius/              # Core Helius skill
├── helius-phantom/      # Phantom frontend skill
├── helius-jupiter/      # Jupiter DeFi skill
├── helius-dflow/        # DFlow trading skill
├── helius-okx/          # OKX trading & intelligence skill
└── svm/                 # SVM architecture skill

每个包含三个变体：

openai.developer.md — 用于OpenAI Responses/Chat Completions API (developer消息)
claude.system.md — 用于Claude API（系统提示）
full.md — 所有引用内联的自包含（Cursor Rules, ChatGPT等）

查看helius-skills/SYSTEM-PROMPTS.md集成指南以获取代码示例。

技能

技能是专家说明集，可以教Claude如何将您的请求路由到正确的MCP操作和参考文件。它们不仅仅是对原始工具的访问 — 它们包括路由逻辑、正确的SDK模式以及防止常见错误的规则。

技能概览

六种可用技能：Build（通用Solana开发）、Phantom（前端dApps）、Jupiter（DeFi）、DFlow（交易应用）、OKX（交易和情报）、SVM（协议内部）

了解更多

Claude代码插件

一键安装MCP + 技能

Helius CLI

命令行账户管理

MCP规范

了解模型上下文协议标准

helius-mcp on npm

包详情和版本历史

变更日志

版本历史和发布说明

贡献

helius-mcp贡献指南

9 个路由工具

账户注册

实时数据

任意 MCP 客户端

​什么是 MCP？

​快速开始

​连接到 Helius MCP 服务器

​公开工具界面

完整工具目录

​路由工具调用形状

​摘要优先响应和expandResult

​注册

​网络配置

​系统提示

​技能

技能概览

​了解更多

Claude代码插件

Helius CLI

MCP规范

helius-mcp on npm

变更日志

贡献

什么是 MCP？

快速开始

连接到 Helius MCP 服务器

公开工具界面

路由工具调用形状

摘要优先响应和`expandResult`

注册

网络配置

系统提示

技能

了解更多