Jupiter MCP 서버

Jupiter의 새로운 Ultra API를 사용하여 Solana 블록체인에서 토큰 스왑을 실행하기 위한 MCP 서버입니다.

노드.js

특징

Jupiter의 Ultra API에서 스왑 주문을 가져오고 DEX 라우팅과 RFQ(견적 요청)를 결합하여 최적의 가격을 책정합니다.
Jupiter의 Ultra API를 통해 스왑을 실행하고 슬리피지, 우선 수수료, 거래 랜딩을 처리합니다.

Related MCP server: Solana Model Context Protocol (MCP) Demo

필수 조건

Node.js : 버전 18 이상(네이티브 fetch 지원).
솔라나 지갑 : 거래에 서명하기 위한 개인 키(base58로 인코딩됨).
RPC 엔드포인트 : Solana RPC 노드에 대한 액세스(예: https://api.mainnet-beta.solana.com ).

설치

저장소 복제 :
지엑스피1
종속성 설치 : MCP 서버 패키지와 기타 필수 종속성이 설치되어 있는지 확인하세요.
npm install
클라이언트 구성 :

{ "mcpServers": { "Jupiter-MCP": { "command": "node", "args": ["path/to/jupiter-mcp/server/index.js"], "env": { "SOLANA_RPC_URL": "solana rpc url you can access", "PRIVATE_KEY": "your private key" } } } }

도구

Ultra API 도구

get-ultra-order :
- 설명 : Jupiter의 Ultra API에서 스왑 주문을 가져와 DEX 라우팅과 RFQ를 모두 활용하여 최적의 가격을 책정합니다.
- 입력 :
  - inputMint : 토큰 채굴 주소(예: SOL 또는 토큰 공개 키)를 입력합니다.
  - outputMint : 출력 토큰 민트 주소(예: USDC 또는 토큰 공개 키).
  - amount : 금액을 문자열로 입력하세요(예: "1.23").
  - slippageBps : 미끄러짐 허용 오차(베이시스 포인트)(예: 0.5%의 경우 50).
- 출력 : requestId , transaction (base64 인코딩), inputMint , outputMint , inAmount , outAmount , price 포함된 JSON입니다.
execute-ultra-order :
- 설명 : 지갑 소유자를 대신하여 스왑 거래를 실행하고 슬리피지, 우선 수수료 및 거래 랜딩을 처리하도록 Jupiter에 요청합니다.
- 입력 :
  - requestId : get-ultra-order 의 고유 식별자입니다.
  - transaction : get-ultra-order 에서 Base64로 인코딩된 거래.
- 출력 : status , transactionId , slot , inputAmountResult , outputAmountResult , swapEvents 포함된 JSON입니다.

예시 상호작용

자연어 프롬프트와 예상 응답을 사용하여 서버와 상호 작용하는 예는 다음과 같습니다.

스왑 주문 가져오기

프롬프트 : "1.23 SOL을 USDC로 거래하는 스왑 주문을 받으세요."
입력 :
- 도구: get-ultra-order
- 인수:
  - inputMint : "So1111111111111111111111111111111111111111111111112" (SOL)
  - outputMint : "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" (USDC)
  - amount : "1.23"
응답 :
{ "requestId": "a770110b-82c9-46c8-ba61-09d955b27503", "transaction": "AQAAAA...base64-encoded-transaction...==", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inAmount": "1230000000", "outAmount": "19950000", "price": 0.01621951219512195 }

스왑 실행

프롬프트 : 제공된 거래를 사용하여 요청 ID 'a770110b-82c9-46c8-ba61-09d955b27503'으로 스왑 주문을 실행합니다.
입력 :
- 도구: execute-ultra-order
- 인수:
  - requestId : "a770110b-82c9-46c8-ba61-09d955b27503"
  - transaction : "AQAAAA...base64로 인코딩된 거래...=="
응답 :
{ "status": "Success", "transactionId": "5x...solana-transaction-signature...", "slot": 299283763, "inputAmountResult": "1230000000", "outputAmountResult": "19950000", "swapEvents": [ { "type": "swap", "inputMint": "So11111111111111111111111111111111111111112", "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "inAmount": "1230000000", "outAmount": "19950000" } ] }