Jupiter MCP Server

Jupiter MCP 服务

一个用于通过 Jupiter 的新 Ultra API 在 Solana 区块链上执行代币兑换的 MCP 服务。

功能

• 从 Jupiter 的 Ultra API 获取兑换订单，结合 DEX 路由和 RFQ（报价请求），以获得最优价格。
• 通过 Jupiter 的 Ultra API 执行兑换，处理滑点、优先费和交易上链。

前置条件

• Node.js：版本 18 或更高版本（支持原生 fetch）。
• Solana 钱包：用于签署交易的私钥（以 base58 编码）。
• RPC 端点：可访问 Solana RPC 节点（例如，https://api.mainnet-beta.solana.com）。

安装

1. 克隆仓库：

   git clone https://github.com/kukapay/jupiter-mcp.git
   cd jupiter-mcp
   

2. 安装依赖项： 确保已安装 MCP Server 软件包以及其他必需的依赖项：

   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：滑点容差，以基点表示（例如，50 表示 0.5%）。
  • 输出：包含 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："So11111111111111111111111111111111111111112"（SOL）
    • outputMint："EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"（USDC）
    • amount："1.23"
    • slippageBps：50
• 响应：

  {
    "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-encoded-transaction...=="
• 响应：

  {
    "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 许可证。详情请参阅 LICENSE 文件。