Jupiter MCP 服务器

使用 Jupiter 的新 Ultra API 在 Solana 区块链上执行代币交换的 MCP 服务器。

Node.js

特征

从 Jupiter 的 Ultra API 获取掉期订单，结合 DEX 路由和 RFQ（报价请求）以获得最佳定价。
通过 Jupiter 的 Ultra API 执行交换，处理滑点、优先费用和交易落地。

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

先决条件

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

安装

克隆存储库：
git clone https://github.com/your-username/jupiter-mcp.git cd jupiter-mcp
安装依赖项：确保您已安装 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 ：“So111111111111111111111111111111111111111111112”（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" } ] }