Jupiter Solana Mcp Server

Jupiter MCP 服务

用于与 Solana 上的 Jupiter Protocol 交互的综合 MCP（Model Context Protocol）服务。支持代币兑换、搜索、投资组合管理和智能错误诊断。

🚀 功能

• 代币兑换：通过 Jupiter 的 Ultra API 执行兑换，并智能处理滑点和费用
• 代币搜索：按代币符号、名称或铸币地址查找代币，并查看详细市场数据
• 投资组合管理：查看钱包中的代币余额和持仓
• 智能诊断：智能检测错误并提供实用的用户指导
• SOL 费用检查：自动验证 SOL 余额是否足以支付交易费用
• 多语言支持：为国际用户提供完整的英文本地化支持

📋 前提条件

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

📦 安装

1. 克隆代码库：

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

2. 安装依赖项：

   npm install
   

3. 设置环境： 复制示例环境文件并配置设置：

   cp .env.example .env
   

4. 配置环境变量： 编辑 .env 文件并填写凭据：

   SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
   PRIVATE_KEY=your_base58_encoded_private_key_here
   JUPITER_API_KEY=your_jupiter_api_key_here
   

5. 客户端配置： 将以下内容添加到 MCP 客户端配置中：

   {
     "mcpServers": {
       "Jupiter-MCP": {
         "command": "node",
         "args": ["path/to/jupiter-mcp/index.js"],
         "env": {
           "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
           "PRIVATE_KEY": "your_base58_encoded_private_key_here",
           "JUPITER_API_KEY": "your_jupiter_api_key_here"
         }
       }
     }
   }
   

🛠️ 可用工具

1. search-token

按代币符号、名称或铸币地址搜索代币，并查看详细的市场信息。

输入：

• query：代币符号（SOL、USDC）、名称（Solana）或铸币地址

返回：全面的代币数据，包括：

• 价格和 24 小时涨跌幅
• 交易量和流动性指标
• 安全审计（铸币/冻结权限状态）
• 热度评分和验证状态
• 持有者数量和市值

2. get-balances

获取任意钱包地址的代币余额，并自动识别代币。

输入：

• walletAddress（可选）：要检查的钱包（默认为已配置的钱包）
• mints（可选）：要检查的特定代币铸币地址

返回：完整的投资组合概览，包括 SOL 和所有 SPL 代币，并提供便于界面显示的金额。

3. get-ultra-order

从 Jupiter 的 Ultra API 获取经过优化的兑换订单，结合 DEX 路由和 RFQ。

输入：

• inputMint：输入代币的铸币地址
• outputMint：输出代币的铸币地址
• amount：输入金额，字符串格式（例如，"1.23"）
• slippageBps：滑点容忍度，以基点表示（例如，50 表示 0.5%）

返回：兑换订单，包含 requestId、transaction、金额和计算出的汇率。

4. execute-ultra-order

执行兑换交易，并智能处理错误和监控状态。

输入：

• requestId：来自 get-ultra-order 的订单 ID
• transaction：以 Base64 编码的交易

返回：执行结果，包括交易签名、Solscan 链接和详细状态。

智能功能：

• ✅ 交易前检查 SOL 余额
• 🔄 自动轮询交易状态（最长 2 分钟）
• 🧠 智能分析错误并提供实用建议
• 🔗 直接链接到 Solscan 交易页面

💡 使用示例

1. 搜索代币

{
  "tool": "search-token",
  "arguments": {
    "query": "BONK"
  }
}

响应：详细的代币信息，包括价格、交易量、安全审计和持有者数量。

2. 检查投资组合余额

{
  "tool": "get-balances",
  "arguments": {}
}

响应：完整的钱包概览，以便于用户查看的格式显示 SOL 和所有 SPL 代币的余额。

3. 执行代币兑换

步骤 1 - 获取报价：

{
  "tool": "get-ultra-order",
  "arguments": {
    "inputMint": "So11111111111111111111111111111111111111112",
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", 
    "amount": "0.1",
    "slippageBps": 50
  }
}

步骤 2 - 执行兑换：

{
  "tool": "execute-ultra-order", 
  "arguments": {
    "requestId": "uuid-from-step-1",
    "transaction": "base64-encoded-transaction-from-step-1"
  }
}

🛡️ 错误处理

该服务提供智能错误检测和用户友好的提示：

• SOL 不足："❌ 交易费用所需的 SOL 不足。请向钱包添加 0.01 SOL（约 $1.25）"
• 滑点问题："⚠️ 超出滑点容差。请尝试提高滑点容差，或稍后重试"
• 网络问题："🔄 交易状态判定超时。你可以使用相同的订单重试"

🔧 故障排除

常见问题

“HTTP 401：未授权”

• 检查环境变量中的 JUPITER_API_KEY
• 在 Jupiter Portal 验证你的 API 密钥

“交易费用所需的 SOL 不足”

• 确保钱包至少有 0.01 SOL 用于支付交易费用
• 使用 get-balances 工具检查 SOL 余额

“RPC 连接失败”

• 确认可以访问你的 SOLANA_RPC_URL
• 尝试使用其他 RPC 端点（Helius、QuickNode 等）

📝 许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。

🤝 贡献

1. Fork 此代码仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

📞 支持

• 问题：GitHub Issues
• Jupiter 文档：Jupiter 开发者文档
• Solana 文档：Solana 开发者文档