Máy chủ Helius MCP

Máy chủ Helius MCP cung cấp cho các công cụ AI quyền truy cập trực tiếp vào API Helius thông qua 10 công cụ công khai — 9 công cụ miền được định tuyến bao quát toàn bộ chức năng của Helius và Solana, cùng expandResult để phân trang qua các phản hồi lớn.

9 Routed Tools

Các công cụ được nhóm theo miền (heliusWallet, heliusAsset, heliusTransaction, …) — mọi thao tác Helius đều có thể được truy cập thông qua một trong các công cụ này

Account Signup

Tạo tài khoản Helius từ công cụ AI — thanh toán qua liên kết được lưu trữ hoặc tự động thanh toán bằng USDC từ một cặp khóa cục bộ

Real-Time Data

Đăng ký Enhanced WebSockets và LaserStream gRPC trực tiếp từ công cụ AI

Any MCP Client

Hoạt động với Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex và mọi công cụ tương thích với MCP

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn nguồn mở do Anthropic giới thiệu, cho phép các mô hình AI kết nối an toàn với các nguồn dữ liệu, công cụ và API bên ngoài. Giao thức này sử dụng kiến trúc máy khách-máy chủ, trong đó một máy chủ lưu trữ (như Claude) kết nối với máy chủ MCP, cho phép AI truy vấn cơ sở dữ liệu, gọi API hoặc thực thi hành động thông qua một giao diện phổ quát, được chuẩn hóa. Tại sao điều này quan trọng đối với Helius: MCP cung cấp cho Claude quyền truy cập trực tiếp vào dữ liệu Solana trực tiếp và cơ sở hạ tầng Helius — số dư, siêu dữ liệu tài sản, giao dịch đã phân tích, quản lý webhook, truyền phát và nhiều chức năng khác. Nếu không có MCP, Claude phải đoán phản hồi API hoặc thực hiện nhiều yêu cầu curl để thu thập ngữ cảnh. MCP cho phép Claude thực sự tương tác với Solana thông qua Helius bằng các lệnh gọi công cụ có cấu trúc.

Trang tài liệu Helius tại helius.dev/docs cũng cung cấp một máy chủ MCP riêng do Mintlify tự động tạo. Máy chủ đó chỉ dành cho việc tìm kiếm tài liệu. helius-mcp được trình bày tại đây là máy chủ toàn diện, bao quát toàn bộ chức năng của Helius và Solana.

Bắt đầu nhanh

Add the MCP server

claude mcp add helius npx helius-mcp@latest

Hoặc thêm vào cấu hình máy chủ MCP của bạn (Claude Desktop, Cursor, Windsurf, VS Code, v.v.):

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

Configure your API key

Nếu bạn đã có khóa:

export HELIUS_API_KEY=YOUR_API_KEY

Hoặc thiết lập khóa bên trong Claude bằng cách gọi thao tác setHeliusApiKey trên heliusAccount. Khóa API được phân giải theo thứ tự sau:

Lệnh gọi thao tác setHeliusApiKey trong phiên
Biến môi trường HELIUS_API_KEY
~/.helius/config.json (được thiết lập qua Helius CLI)

Nếu bạn cần tài khoản mới: Xem phần Đăng ký bên dưới.

Start using tools

Đặt câu hỏi bằng tiếng Anh thông thường — công cụ và thao tác phù hợp sẽ được chọn tự động:

“Ví này sở hữu những NFT nào?”
“Phân tích giao dịch này: 5abc...”
“Lấy số dư của Gh9ZwEm...”
“Gửi 1 SOL đến 7xKp...”
“Tạo webhook cho địa chỉ này”

Kết nối với máy chủ Helius MCP

Chạy lệnh sau:

claude mcp add helius npx helius-mcp@latest

Hoặc thêm vào .mcp.json của dự án:

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

Xác minh bằng:

claude mcp list

Muốn cài đặt kỹ năng + MCP trong một bước? Hãy cài đặt plugin Helius. Chạy hai lệnh sau riêng biệt:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Mở Settings > Developer > Edit Config và thêm máy chủ:

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

Khởi động lại Claude Desktop để áp dụng.

Mở bảng lệnh (Cmd/Ctrl + Shift + P), tìm kiếm MCP: Add Server và nhập:

Tên: helius
Lệnh: npx helius-mcp@latest

Hoặc thêm vào .cursor/mcp.json của dự án:

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

Tạo tệp .vscode/mcp.json trong thư mục gốc của dự án:

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

Yêu cầu tiện ích GitHub Copilot đã bật hỗ trợ MCP.

Mở bảng lệnh (Cmd/Ctrl + Shift + P), tìm kiếm Configure MCP Servers và thêm:

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

Chạy lệnh sau:

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

Hoặc thêm vào ~/.codex/config.toml của bạn (hoặc .codex/config.toml nếu chỉ áp dụng cho dự án):

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

Xác minh bằng:

codex mcp list

Danh sách công cụ công khai

Helius MCP cung cấp 10 công cụ công khai: 9 công cụ miền được định tuyến cùng expandResult. Mọi thao tác Helius và Solana đều có thể được truy cập dưới dạng đối số action trên công cụ định tuyến tương ứng.

Công cụ	Phạm vi
`heliusAccount`	Thiết lập tài khoản, xác thực, gói dịch vụ, thanh toán
`heliusWallet`	Số dư ví, tài sản nắm giữ, lịch sử, danh tính
`heliusAsset`	Tài sản, NFT, bộ sưu tập, người nắm giữ token
`heliusTransaction`	Phân tích giao dịch và lịch sử giao dịch của ví
`heliusChain`	Trạng thái chuỗi, tài khoản token, khối, trạng thái mạng, tài khoản chương trình
`heliusStreaming`	CRUD webhook và cấu hình đăng ký (WebSockets, LaserStream)
`heliusKnowledge`	Tài liệu, hướng dẫn, giá, khắc phục sự cố, mã nguồn, blog, SIMD
`heliusWrite`	Chuyển khoản — token SOL và SPL
`heliusCompression`	Bằng chứng Merkle cho NFT nén
`expandResult`	Mở rộng đầu ra ưu tiên bản tóm tắt theo `resultId`

Full Tool Catalog

Mọi thao tác được nhóm theo công cụ định tuyến, kèm chi tiết về cấu trúc lệnh gọi và cách sử dụng expandResult

Cấu trúc lệnh gọi công cụ định tuyến

Mỗi công cụ trong số 9 công cụ định tuyến đều có cấu trúc chung:

action — tên thao tác Helius cần chạy, chẳng hạn như getBalance hoặc createWebhook
các tham số dành riêng cho miền — ví dụ address, signatures hoặc webhookURL
detail tùy chọn — summary, standard hoặc full
các trường đo từ xa — _feedback, _feedbackTool, _model

Lệnh gọi mẫu:

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

Phản hồi ưu tiên bản tóm tắt và `expandResult`

Các phản hồi lớn sẽ ưu tiên bản tóm tắt. Công cụ định tuyến trả về một bản tóm tắt ngắn gọn cùng resultId khi phản hồi đầy đủ có kích thước lớn hoặc khi detail: "summary" được yêu cầu. Sử dụng expandResult với resultId đó để tìm nạp một phần, phạm vi, trang hoặc lát dữ liệu tiếp theo cụ thể theo yêu cầu. Cách này giúp giảm mức sử dụng token cho các truy vấn thăm dò, đồng thời vẫn cho phép tác nhân xem sâu vào toàn bộ tải trọng khi cần.

Đăng ký

Tạo tài khoản Helius từ công cụ AI thông qua liên kết thanh toán được lưu trữ hoặc bằng cách thanh toán USDC trực tiếp từ một cặp khóa cục bộ. Quy trình đăng ký chạy qua công cụ định tuyến heliusAccount:

Generate a keypair

AI gọi heliusAccount với action: "generateKeypair" — thao tác này tạo một ví Solana và trả về địa chỉ.

Create the payment intent

AI gọi heliusAccount với action: "signup" và mode: "link" — trả về paymentUrl (ví dụ: https://dashboard.helius.dev/pay/<id>) để người dùng mở và thanh toán bằng bất kỳ ví nào. Hoặc truyền mode: "autopay" để tự động gửi USDC từ cặp khóa cục bộ (ví phải có khoảng 0,001 SOL + số tiền của gói dịch vụ bằng USDC).

Resume after payment

Sau khi thanh toán qua liên kết, AI gọi heliusAccount với action: "signup" và mode: "resume" — thăm dò ý định thanh toán, hoàn tất việc cấp tài khoản và tự động cấu hình khóa API.

Thông tin liên hệ: mọi lượt đăng ký mới — bao gồm cả gói Agent — đều yêu cầu email, firstName và lastName. upgradePlan cũng yêu cầu các thông tin tương tự.

Hoặc thực hiện tương tự từ terminal bằng 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

Cấu hình mạng

Máy chủ MCP mặc định sử dụng mainnet-beta. Chuyển sang devnet qua biến môi trường:

export HELIUS_NETWORK=devnet

Hoặc gọi thao tác setNetwork trên heliusAccount trong một phiên.

Lời nhắc hệ thống

Gói helius-mcp đi kèm các lời nhắc hệ thống dựng sẵn, hướng dẫn mô hình AI cách sử dụng hiệu quả các công cụ Helius. Chúng nằm trong 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

Mỗi lời nhắc có ba biến thể:

openai.developer.md — dành cho OpenAI Responses/Chat Completions API (thông báo developer)
claude.system.md — dành cho Claude API (lời nhắc hệ thống)
full.md — độc lập, với tất cả tham chiếu được nhúng trực tiếp (Cursor Rules, ChatGPT, v.v.)

Xem hướng dẫn tích hợp helius-skills/SYSTEM-PROMPTS.md để biết các ví dụ mã.

Kỹ năng

Kỹ năng là các bộ hướng dẫn chuyên môn giúp Claude định tuyến yêu cầu của bạn đến đúng thao tác MCP và tệp tham chiếu. Chúng không chỉ cung cấp quyền truy cập công cụ thô — chúng còn bao gồm logic định tuyến, các mẫu SDK chính xác và quy tắc ngăn ngừa những lỗi phổ biến.

Skills Overview

Có sáu kỹ năng: Build (phát triển Solana nói chung), Phantom (dApp giao diện người dùng), Jupiter (DeFi), DFlow (ứng dụng giao dịch), OKX (giao dịch và thông tin chuyên sâu) và SVM (cơ chế nội bộ của giao thức)

Tìm hiểu thêm

Claude Code Plugin

Cài đặt MCP + kỹ năng chỉ bằng một lần nhấp

Helius CLI

Quản lý tài khoản bằng dòng lệnh

MCP Specification

Tìm hiểu về tiêu chuẩn Model Context Protocol

helius-mcp on npm

Chi tiết gói và lịch sử phiên bản

Changelog

Lịch sử phiên bản và ghi chú phát hành

Contribute

Hướng dẫn đóng góp cho helius-mcp

9 Routed Tools

Account Signup

Real-Time Data

Any MCP Client

​MCP là gì?

​Bắt đầu nhanh

​Kết nối với máy chủ Helius MCP

​Danh sách công cụ công khai

Full Tool Catalog

​Cấu trúc lệnh gọi công cụ định tuyến

​Phản hồi ưu tiên bản tóm tắt và expandResult

​Đăng ký

​Cấu hình mạng

​Lời nhắc hệ thống

​Kỹ năng

Skills Overview

​Tìm hiểu thêm

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

MCP là gì?

Bắt đầu nhanh

Kết nối với máy chủ Helius MCP

Danh sách công cụ công khai

Cấu trúc lệnh gọi công cụ định tuyến

Phản hồi ưu tiên bản tóm tắt và `expandResult`

Đăng ký

Cấu hình mạng

Lời nhắc hệ thống

Kỹ năng

Tìm hiểu thêm