Helius MCPサーバー

Helius MCPサーバーは、AIツールにHelius APIへの直接アクセスを提供します。10の公開ツール — HeliusとSolanaのすべての機能をカバーする9つのルーティングされたドメインツールおよび大容量レスポンスをページングするためのexpandResultを備えています。

9つのルーティングツール

ドメインでグループ化されたツール（heliusWallet、heliusAsset、heliusTransaction、…）— すべてのHeliusアクションにアクセス可能です

アカウント登録

AIツールからHeliusアカウントを作成—ホストリンクまたはローカルキーペアからUSDCの自動支払いで支払い

リアルタイムデータ

AIツールから直接Enhanced 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.dev/docsのHeliusドキュメントサイトも、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プラグインをインストールしてください。次の2つのコマンドとして実行します:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

設定 > 開発者 > 設定を編集を開き、サーバーを追加します:

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

Claude Desktopを再起動して適用します。

コマンドパレット（Cmd/Ctrl + Shift + P）を開き、MCP: サーバーを追加を検索して入力します:

名前: 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"]
    }
  }
}

GitHub Copilot拡張機能が必要で、MCPサポートが有効になっている必要があります。

コマンドパレット（Cmd/Ctrl + Shift + P）を開き、MCPサーバーを設定を検索して追加します:

{
  "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`	ドキュメント、ガイド、価格設定、トラブルシューティング、ソース、ブログ、SIMD
`heliusWrite`	移転 — SOLおよびSPLトークン
`heliusCompression`	圧縮NFTのマークル証明
`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`

大容量のレスポンスはサマリー優先です。ルーティングされたツールはコンパクトなサマリーを返し、フルレスポンスが大きい場合やdetail: "summary"を要求された場合にはresultIdも返します。必要に応じて特定のセクション、範囲、ページ、または継続スライスを取得するためにexpandResultを使用してください。これにより、探査的なクエリのトークン使用を低く抑えながら、必要に応じて代理が完全なペイロードに掘り下げることができます。

サインアップ

ホストされた支払いリンクを介して、またはローカルキーペアから直接USDCを支払うことで、AIツールからHeliusアカウントを作成します。サインアップフローは、heliusAccountルーティングツールを介して実行されます。

キーペアを生成

heliusAccountをaction: "generateKeypair"で呼び出すと、Solanaウォレットが作成され、アドレスが返されます。

支払い意図を作成

heliusAccountをaction: "signup"およびmode: "link"で呼び出すと、ユーザーが任意のウォレットで支払うために開くpaymentUrl（例: https://dashboard.helius.dev/pay/<id>）が返されます。または、ローカルキーペアからUSDCを自動送信するためにmode: "autopay"を渡します（ウォレットには約0.001 SOL + プランの金額分のUSDCが必要です）。

支払い後に再開

リンクで支払った後、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

または、セッション内でheliusAccountのsetNetworkアクションを呼び出します。

システムプロンプト

helius-mcpパッケージには、Heliusツールを効果的に使用する方法をAIモデルに教えるために事前構築されたシステムプロンプトが付属しています。これらは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

各プロンプトには3つのバリエーションがあります:

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パターン、一般的な間違いを防ぐルールを含みます。

スキル概要

6つのスキルが利用可能: Build（一般的なSolana開発）、Phantom（フロントエンドdApps）、Jupiter（DeFi）、DFlow（トレーディングアプリ）、OKX（トレーディングとインテリジェンス）、SVM（プロトコル内部）

詳細を学ぶ

Claude Codeプラグイン

MCP + スキルをワンクリックでインストール

Helius CLI

コマンドラインによるアカウント管理

MCP仕様

モデルコンテキストプロトコル標準について学ぶ

npmでのhelius-mcp

パッケージの詳細とバージョン履歴

チェンジログ

バージョン履歴とリリースノート

貢献する

helius-mcpの貢献ガイド

9つのルーティングツール

アカウント登録

リアルタイムデータ

任意のMCPクライアント

​MCPとは

​クイックスタート

​Helius MCPサーバーへの接続

​公開ツール表面

フルツールカタログ

​ルーティングされたツールの呼び出し形状

​サマリー優先のレスポンスとexpandResult

​サインアップ

​ネットワーク構成

​システムプロンプト

​スキル

スキル概要

​詳細を学ぶ

Claude Codeプラグイン

Helius CLI

MCP仕様

npmでのhelius-mcp

チェンジログ

貢献する

MCPとは

クイックスタート

Helius MCPサーバーへの接続

公開ツール表面

ルーティングされたツールの呼び出し形状

サマリー優先のレスポンスと`expandResult`

サインアップ

ネットワーク構成

システムプロンプト

スキル

詳細を学ぶ