Helius MCP 서버 - Helius Docs

Helius MCP 서버는 AI 도구가 10개의 공용 도구를 통해 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 인프라 — 잔액, 자산 메타데이터, 구문 분석된 트랜잭션, 웹훅 관리, 스트리밍 등에 직접 액세스할 수 있는 권한을 부여합니다. 이를 통해 Claude는 API 응답을 추측하거나 반복적으로 curl 요청을 보내야 얻을 수 있는 컨텍스트를 획득할 수 있습니다. Helius를 통한 MCP는 Claude가 구조화된 도구 호출을 사용하여 실제로 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

또는 Claude 내부에서 setHeliusApiKey 작업을 호출하여 설정하십시오 heliusAccount. API 키는 다음 순서로 해결됩니다:

세션 내 setHeliusApiKey 작업 호출
HELIUS_API_KEY 환경 변수
~/.helius/config.json ( Helius CLI를 통해 설정)

새로운 계정이 필요한 경우: 아래의 가입을 참조하십시오.

도구 사용 시작

평범한 영어로 질문하십시오 — 적절한 도구와 작업이 자동으로 선택됩니다:

“이 지갑이 소유한 NFT는 무엇인가요?”
“이 트랜잭션 구문 분석: 5abc...”
“Gh9ZwEm...의 잔액을 얻으십시오”
“7xKp...에게 1 SOL 보내기”
“이 주소에 대한 웹훅 생성하기”

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를 검색하고 입력하세요:

Name: helius
Command: 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

Public Tool Surface

Helius MCP는 10개의 공개 도구를 제공합니다: 9개의 라우팅된 도메인 도구와 expandResult. 모든 Helius 및 Solana 작업은 적절한 라우팅된 도구의 action 인수로 접근할 수 있습니다.

Tool	Scope
`heliusAccount`	계정 설정, 인증, 계획, 청구
`heliusWallet`	지갑 잔액, 보유물, 기록, 신원
`heliusAsset`	자산, NFT, 컬렉션, 토큰 소유자
`heliusTransaction`	트랜잭션 파싱 및 지갑 트랜잭션 기록
`heliusChain`	체인 상태, 토큰 계정, 블록, 네트워크 상태, 프로그램 계정
`heliusStreaming`	웹훅 CRUD 및 구독 설정 (WebSockets, LaserStream)
`heliusKnowledge`	문서, 가이드, 가격, 문제 해결, 소스, 블로그, SIMD
`heliusWrite`	전송 — SOL 및 SPL 토큰
`heliusCompression`	압축된 NFT의 머클 증명
`expandResult`	요약 우선 출력을 `resultId`로 확장합니다

Full Tool Catalog

모든 작업이 라우팅된 도구로 그룹화되어 있으며, 호출 형태 세부 정보와 expandResult 사용법 포함

Routed tool call shape

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"
  }
}

Summary-first responses and `expandResult`

무거운 응답은 요약 우선입니다. 라우팅된 도구는 간결한 요약과 함께 큰 응답이 예상되거나 INLINE_CODE_PLACEHOLDER_494d9a5c9a4993e4_END가 요청될 때 resultId를 반환합니다. 특정 섹션, 범위, 페이지 또는 지속 조각을 필요할 때 가져오기 위해 expandResult를 사용합니다. 이렇게 하면 탐색 쿼리의 토큰 사용량을 줄이면서 필요한 경우 에이전트가 전체 페이로드를 심층적으로 탐색할 수 있습니다. 호스팅된 결제 링크를 통해 또는 로컬 키페어에서 USDC를 직접 지불하여 AI 도구에서 Helius 계정을 만드세요. 가입 흐름은 heliusAccount 라우팅 도구를 통해 실행됩니다:

Generate a keypair

AI가 heliusAccount를 action: "generateKeypair"로 호출합니다 — 솔라나 지갑을 만들고 주소를 반환합니다.

Create the payment intent

AI가 heliusAccount를 action: "signup"와 mode: "link"로 호출합니다 — 사용자가 지불할 수 있는 paymentUrl (예: https://dashboard.helius.dev/pay/<id>)를 반환합니다. 또는 mode: "autopay"를 전달하여 로컬 키페어에서 USDC를 자동으로 전송합니다 (지갑에는 약 0.001 SOL + 계획 금액의 USDC가 있어야 합니다).

Resume after payment

링크를 통해 지불한 후, 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

Network Configuration

MCP 서버는 기본적으로 mainnet-beta입니다. 환경 변수를 통해 devnet으로 전환하세요:

export HELIUS_NETWORK=devnet

또는 세션 내에서 setNetwork를 heliusAccount 작업으로 호출하세요.

System Prompts

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 응답/Chat Completions API용 (developer 메시지)
claude.system.md — Claude API용 (시스템 프롬프트)
full.md — 모든 참조가 인라인된 자체 포함형 (Cursor Rules, ChatGPT 등)

helius-skills/SYSTEM-PROMPTS.md 통합 가이드를 보고 코드 예제를 확인하세요.

Skills

Skills는 Claude에게 요청을 올바른 MCP 작업 및 참조 파일로 라우팅하는 방법을 가르치는 전문가 지침 세트입니다. 이는 원시 도구 접근을 넘어 라우팅 로직, 올바른 SDK 패턴, 일반적인 실수를 예방하는 규칙을 포함합니다.

Skills Overview

여섯 가지 기술 사용 가능: Build (일반 Solana 개발), Phantom (프론트엔드 dApps), Jupiter (DeFi), DFlow (거래 앱), OKX (거래 및 인텔리전스), SVM (프로토콜 내부)

더 알아보기

Claude Code Plugin

MCP + 기술의 원클릭 설치

Helius CLI

명령 줄 계정 관리

MCP Specification

모델 컨텍스트 프로토콜 표준에 대해 배우기

helius-mcp on npm

패키지 세부 정보 및 버전 기록

Changelog

버전 기록 및 릴리즈 노트

Contribute

helius-mcp에 대한 기여 가이드

9 라우팅 도구

계정 가입

실시간 데이터

어떤 MCP 클라이언트든

​MCP란 무엇인가요?

​빠른 시작

​Helius MCP 서버에 연결하기

​Public Tool Surface

Full Tool Catalog

​Routed tool call shape

​Summary-first responses and expandResult

​Signup

​Network Configuration

​System Prompts

​Skills

Skills Overview

​더 알아보기

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

MCP란 무엇인가요?

빠른 시작

Helius MCP 서버에 연결하기

Public Tool Surface

Routed tool call shape

Summary-first responses and `expandResult`

Signup

Network Configuration

System Prompts

Skills

더 알아보기