Jupiter MCP 서버

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

특징

• 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. 저장소 복제 :

   지엑스피1

2. 종속성 설치 : MCP 서버 패키지와 기타 필수 종속성이 설치되어 있는지 확인하세요.

   npm install

3. 클라이언트 구성 :

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

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.