Helius dành cho tác nhân AI

Helius MCP Server: Bộ công cụ

Model Context Protocol (MCP) là một tiêu chuẩn mã 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 nguồn dữ liệu, công cụ và API bên ngoài. Tiêu chuẩn này thay thế các tích hợp tùy chỉnh bằng một giao diện phổ quát, được chuẩn hóa. 

Helius MCP Server cung cấp quyền truy cập vào Helius—và Solana—cho mọi MCP client.

Nếu không có MCP, một tác nhân muốn kiểm tra số dư ví phải mở shell, tạo một lệnh curl, gửi lệnh, phân tích đầu ra JSON và hy vọng rằng endpoint cùng các tham số đều chính xác.

Lặp lại quy trình đó cho mọi lệnh gọi API trong một workflow sẽ tạo ra các tương tác chậm, mong manh và dễ lỗi, đồng thời bị cản trở bởi việc phải khởi tạo một phiên shell cho từng lệnh.

Với MCP, tất cả những bước đó đều không cần thiết.

Tác nhân gọi getBalance dưới dạng một lệnh gọi công cụ có cấu trúc và nhận về phản hồi có kiểu. Không cần shell. Không cần curl. Không cần phân tích đầu ra—mọi thứ tự vận hành.

Điều tương tự cũng áp dụng cho parseTransaction, getAssetsByOwner, createWebhook và hơn 60 công cụ khác. Giờ đây, tác nhân có thể sử dụng trực tiếp Helius với đúng tham số để nhận lại dữ liệu có cấu trúc. 

Helius MCP Server cung cấp công cụ cho:

• Đăng ký tự động: tạo tài khoản, lấy khóa API, nâng cấp, v.v.
• Dữ liệu blockchain trực tiếp: RPC, DAS API, ZK Compression và nhiều tính năng khác
• Truyền phát dữ liệu:  WebSockets (tiêu chuẩn và nâng cao), LaserStream gRPC (độ trễ cấp shred)
• Gửi giao dịch: Priority Fee API, chuyển SPL và Sender
• Webhook: Tạo, cập nhật và xóa thông báo theo sự kiện
• Ví và lịch sử: số dư, giao dịch chuyển, phân tích giao dịch, danh tính ví và phân tích nguồn tiền
• Kiến thức về Solana: SIMD, tham chiếu mã nguồn Agave và Firedancer, nội dung blog Helius và tìm kiếm tài liệu Solana chính thức

Cài đặt nhanh

Để thêm Helius MCP Server bằng Claude Code, hãy chạy:

claude mcp add helius npx helius-mcp@latest

Với Codex, hãy chạy:

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

Với Cursor, VS Code hoặc các công cụ tương tự, hãy thêm vào cấu hình MCP:

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

Sau đó, thiết lập khóa API bằng công cụ setHeliusApiKey hoặc biến môi trường (ví dụ: HELIUS_API_KEY) và bắt đầu triển khai.

Nếu là người dùng mới, tác nhân có thể tự động tạo tài khoản cho bạn—tác nhân sẽ tạo một cặp khóa, bạn nạp tiền vào đó rồi gọi agenticSignup để mua gói mong muốn với giá từ $1. 

Helius Skills: Bộ não

MCP cho phép tác nhân truy cập hơn 60 công cụ. Tuy nhiên, chỉ có quyền truy cập là chưa đủ—một tác nhân sở hữu danh mục công cụ cũng giống như một nhà phát triển mở sẵn các tab tài liệu nhưng không có chút kinh nghiệm nào. Tác nhân có thể gọi công cụ, nhưng không biết nên chọn công cụ nào, kết hợp chúng ra sao cho một tác vụ cụ thể hoặc cần tránh những lỗi gì. 

Các kỹ năng chính là bộ não. Đây là những bộ hướng dẫn chuyên sâu—các prompt được xây dựng cẩn thận với logic định tuyến, tệp tham chiếu và quy tắc—giúp tác nhân trở thành một nhà phát triển Solana chuyên nghiệp.

Khi một kỹ năng được tải, tác nhân biết rằng searchAssets phù hợp hơn getProgramAccounts để tra cứu NFT, phí ưu tiên cần được truy xuất động qua getPriorityFeeEstimates và giao dịch nên được gửi qua Sender để đạt tỷ lệ được ghi nhận cao nhất. Các kỹ năng cung cấp cho tác nhân chuyên môn theo lĩnh vực.

Hôm nay, chúng tôi ra mắt bốn Helius Skills chính:

Build

Kỹ năng Build dành cho hoạt động phát triển Solana cốt lõi. Kỹ năng này định tuyến đến đúng công cụ cho DAS, Sender, WebSockets, LaserStream, Webhook, Enhanced Transactions, phân tích ví và quy trình bắt đầu sử dụng. Đây là kỹ năng mặc định để xây dựng mọi thứ trên Solana bằng Helius. 

DFlow

Kỹ năng DFlow dành cho việc xây dựng ứng dụng giao dịch. Kỹ năng này kết hợp các API DFlow (như hoán đổi giao ngay, thị trường dự đoán, truyền phát theo thời gian thực và Proof KYC) với hạ tầng Helius để gửi giao dịch, tối ưu hóa phí và giám sát on-chain. 

Phantom

Kỹ năng Phantom dành cho việc xây dựng ứng dụng frontend bằng Phantom Connect SDK. Kỹ năng này bao gồm kết nối ví, kiểm soát quyền truy cập bằng token, mint NFT, thanh toán bằng tiền mã hóa, hiển thị danh mục đầu tư và kiến trúc frontend an toàn.

SVM

Kỹ năng SVM giúp tác nhân hiểu các thành phần nội bộ của giao thức Solana. Khám phá cách bytecode sBPF được thực thi, các yếu tố cần cân nhắc trong thiết kế Alpenglow, kinh tế học validator và nhiều chủ đề khác bằng cách truy xuất nội dung trực tiếp từ blog Helius, SIMD và mã nguồn Agave/Firedancer. Không cần khóa API.

Cách các kỹ năng hoạt động

Các kỹ năng không phụ thuộc vào mô hình. Mỗi kỹ năng đi kèm các biến thể system prompt dựng sẵn để hoạt động trên mọi nền tảng, không chỉ Claude.

Sử dụng openai.developer.md cho OpenAI API, claude.system.md cho Claude API hoặc full.md cho Cursor Rules, hướng dẫn tùy chỉnh của ChatGPT hay bất kỳ công cụ nào khác. Xem tổng quan về Skills để biết cách thiết lập dành riêng cho từng nền tảng.

Các kỹ năng được cài đặt tự động khi sử dụng Helius Claude Code Plugin. Có thể cài đặt từng kỹ năng độc lập dưới dạng Agent Skills—tự động được gọi mà không cần lệnh gạch chéo:

# 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/

Với các kỹ năng này, tác nhân có thể xây dựng gần như mọi ứng dụng Solana—từ frontend giao dịch, ứng dụng thị trường dự đoán đến bộ xử lý thanh toán bằng stablecoin—và áp dụng đúng mẫu ngay từ đầu.

Helius Claude Code Plugin: Gói tích hợp

MCP cung cấp công cụ, còn các kỹ năng đóng vai trò bộ não. Helius Claude Code Plugin là gói tích hợp—chỉ cần cài đặt một lần để kết nối mọi thứ với nhau. Mọi thứ tự vận hành.

Plugin tích hợp Helius MCP, DFlow MCP, cả bốn kỹ năng và các tệp tham chiếu chuyên sâu cho mọi sản phẩm Helius.

Không cần cấu hình MCP thủ công. Không cần thiết lập riêng từng kỹ năng.

Chỉ cần cài đặt một lần, tác nhân sẽ có quyền truy cập blockchain có cấu trúc và kiến thức Solana chuyên sâu trong cùng một phiên.

Cài đặt nhanh

Sau đây là cách cài đặt Helius Plugin từ marketplace của Claude Code:

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

Chỉ vậy thôi. Plugin tự động khởi động cả hai MCP server và hiện cung cấp bốn lệnh gạch chéo:

Cách thiết lập khóa API giống như với MCP độc lập: sử dụng khóa hiện có, bật tính năng đăng ký tự động hoặc dùng Helius CLI. 

Cách hoạt động trong thực tế

Sau khi cài đặt plugin, bạn có thể chuyển từ một prompt duy nhất thành một ứng dụng hoạt động hoàn chỉnh. Ví dụ:

“Hãy xây dựng cho tôi một CLI báo cáo thuế để tôi có thể truy xuất hoạt động on-chain của Toly bằng địa chỉ ví 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Bắt đầu với tháng trước (tháng 2) và xuất một tệp CSV liệt kê tất cả các sự kiện chịu thuế của anh ấy. Hãy xây dựng sao cho công cụ hoạt động với mọi ví và mọi khoảng thời gian.”

Claude hoàn thành chỉ trong một lượt:   

Kỹ năng /helius:build được kích hoạt và đề xuất chính xác getTransactionsByAddress cùng tính năng phân trang và lọc theo dấu thời gian để trả về toàn bộ lịch sử giao dịch đã được phân tích dựa trên hoạt động gần đây của Toly.

Không cần chọn công cụ thủ công hay nhập thêm prompt trung gian. Tác nhân đọc đúng tệp tham chiếu, gọi đúng công cụ MCP và tạo ra một CLI hoạt động với mọi ví cũng như mọi khoảng ngày.

Tất nhiên, tác nhân có thể xây dựng những ứng dụng phức tạp hơn, chẳng hạn như bot giao dịch:

Trong ví dụ này, chúng tôi đã cài đặt Helius Claude Code Plugin và yêu cầu Claude xây dựng một bot giao dịch theo dõi token PumpFun theo thời gian thực, truyền phát thông tin tạo token và giao dịch qua LaserStream.

Chúng tôi cũng yêu cầu bot hiển thị dữ liệu thị trường và cung cấp biểu đồ cơ bản để có thể thực hiện giao dịch mô phỏng. Chỉ vậy thôi. Claude đã xây dựng bot giao dịch này, hoàn chỉnh với tính năng truyền phát token và giao dịch trực tiếp, trong chưa đầy 10 phút.

Đó là sự khác biệt giữa việc cung cấp công cụ và cung cấp chuyên môn cho một tác nhân.

Helius CLI

Helius CLI là một giao diện dòng lệnh đầy đủ tính năng với hơn 95 lệnh CLI, bao quát mọi thứ từ quản lý tài khoản, truy vấn Solana, gửi giao dịch, quản lý webhook và truyền phát theo thời gian thực cho đến staking, ZK Compression cùng nhiều tính năng khác.

Dù chúng tôi khuyến nghị dùng MCP cho các workflow do AI điều khiển—lệnh gọi công cụ có cấu trúc hiệu quả hơn việc khởi tạo phiên shell và phân tích đầu ra—CLI vẫn là lựa chọn phù hợp cho script shell, xây dựng pipeline CI/CD hoặc làm việc trong môi trường không hỗ trợ MCP. Mọi lệnh đều hỗ trợ tùy chọn --json để tạo đầu ra máy có thể đọc và trả về mã thoát có cấu trúc, cho phép quy trình tự động xử lý lỗi bằng mã chương trình.

Cài đặt nhanh

Với người dùng mới, quy trình rất đơn giản:

# 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

Với người dùng hiện tại, chỉ cần:

helius config set-api-key YOUR_API_KEY

SDK được tối ưu hóa cho tác nhân

Đối với các tác nhân xây dựng ứng dụng bằng mã chương trình, chúng tôi đã phát hành tài liệu tối ưu hóa cho tác nhân dành cho TypeScript SDK và Rust SDK.

Các trang này trình bày những mẫu được khuyến nghị cho các workflow tác nhân phổ biến, bao gồm gửi giao dịch qua Sender, xử lý theo lô, dữ liệu thời gian thực, phân trang và xử lý lỗi. 

TypeScript SDK

Helius TypeScript SDK cung cấp các phương thức an toàn về kiểu cho mọi lệnh gọi API Helius. Điểm quan trọng đối với tác nhân là các phương thức dành riêng cho Helius có thể rút gọn workflow Solana nhiều bước thành một lệnh gọi duy nhất. 

Ví dụ: getTransactionsForAddress thay thế mẫu hai bước tiêu chuẩn đã lỗi thời gồm truy xuất chữ ký rồi truy xuất giao dịch—chỉ một lệnh gọi với tính năng lọc phía server, khoảng thời gian và hỗ trợ tài khoản token: 

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" },
  },
]);

Tương tự, sendSmartTransaction tự động xử lý mô phỏng, ước tính đơn vị tính toán, phí ưu tiên và xác nhận.

sendTransactionWithSender nâng khả năng này lên một tầm cao mới, được tối ưu hóa để gửi giao dịch với độ trễ cực thấp.

Xem các phương pháp hay nhất cho TypeScript để tìm hiểu về xử lý theo lô, phân trang, dữ liệu thời gian thực qua webhook và WebSockets, truy xuất tài khoản tăng dần, xử lý lỗi cùng những lỗi phổ biến mà tác nhân nên tránh. 

Rust SDK

Helius Rust SDK cung cấp các binding Rust bất đồng bộ với cùng các phương thức Helius, rất phù hợp cho workflow tác nhân hiệu năng cao:

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 cũng cung cấp các biến thể lỗi có kiểu (ví dụ: HeliusError::RateLimitExceeded), nhờ đó tác nhân có thể đối sánh trực tiếp theo lỗi thay vì phân tích chuỗi.

Xem các phương pháp hay nhất cho Rust để tìm hiểu những mẫu tương tự trong Rust (như xử lý theo lô, phân trang, Sender, chiến lược thử lại và các lỗi phổ biến). 

Bắt đầu

Helius cung cấp cho tác nhân bộ công cụ toàn diện nhất để xây dựng ứng dụng sẵn sàng cho môi trường production trên Solana. Sau đây là cách bắt đầu:

• Cách nhanh nhất: Cài đặt Claude Code Plugin 
• Mọi MCP client: Thêm Helius MCP Server vào Claude Desktop, Cursor, VS Code, Codex hoặc Windsurf
• Tự động hóa shell: Cài đặt Helius CLI cho script và CI/CD
• Tích hợp API: Thêm system prompt của kỹ năng vào OpenAI API, Claude API hoặc ChatGPT

Đọc tài liệu, khám phá repo GitHub, đề xuất tích hợp kỹ năng và liên hệ đội ngũ hỗ trợ nếu bạn có bất kỳ câu hỏi nào.