用途
jupiter-mcp 是一个面向 Jupiter API 的 Model Context Protocol（MCP）服务器。Jupiter 被描述为 Solana 上首屈一指的 DEX 聚合器。该服务器通过 Ultra API 支持即时兑换，通过 Trigger API 支持限价订单，供 MCP 客户端调用。
主要能力
提供的工具分为两类：
- Ultra API（即时兑换）：执行交换相关操作。
- Trigger API（限价订单）：管理限价订单。
根据文档说明，以下操作为免费（仅 API 调用）：get_swap_quote、get_balances、get_shield、search_token、create_limit_order、cancel_limit_order、cancel_limit_orders、get_limit_orders。
以下操作为付费（执行真实交易并消耗 SOL）：execute_swap_transaction、execute_limit_order。
交换与限价订单的区别
- 交换（Ultra API）：以当前市场价格立即执行。
- 限价订单（Trigger API）：当目标价格达到时自动执行。
自动推荐系统
所有订单包含 255 个基点（2.55%）的推荐费（允许的上限）。推荐钱包地址为 8cK8hCyRQCp52nVuPLnLL71afkRvRcFibSwHMjGFT8bm。文档注明：仅对具有推荐代币账户的代币收取费用（目前为 SOL），用于支持开发与维护。
使用方式
前置条件
- Node.js 与 npx（用于 envmcp 支持）：从 https://nodejs.org/ 下载，使用 npx --version 验证。
- uv/uvx（Python 包管理器）：从 https://docs.astral.sh/uv/getting-started/installation/ 安装。macOS/Linux：curl -LsSf https://astral.sh/uv/install.sh | sh；Windows：powershell -c "irm https://astral.sh/uv/install.ps1 | iex"；使用 uvx --version 验证。
预构建桌面扩展（DXT）
下载 jupiter-mcp-latest.dxt。该 DXT 包含：Claude Desktop 一键安装、使用 uvx 自动管理依赖、安全的环境变量配置、内置错误处理与调试。DXT 文件在每次提交时自动更新。
安装选项
- 选项 1：Claude Desktop DXT（推荐）——下载 DXT 文件并双击安装，详见 dxt/README.md。
- 选项 2：使用 Cursor 快速安装——复制链接并粘贴到浏览器地址栏或 Cursor 命令面板，按提示完成安装；需要将 REPLACE_THIS 替换为实际的 Solana 私钥。文档注明这些链接仅在 Cursor 中有效。
MCP 配置
将相应配置添加到 MCP 客户端配置中。也可使用 .env 文件方式加载环境变量，以避免在 MCP 配置中存储敏感数据；该方式使用 envmcp 从 .env 文件安全加载 PRIVATE_KEY，需将 ENV_FILE_PATH 替换为 .env 文件的绝对路径（例如 /Users/yourname/.env 或 /home/user/.env）。
所需环境变量：
- PRIVATE_KEY：base58 编码的 Solana 私钥（从 Phantom 钱包导出）。
- 可选：若使用自定义 RPC 端点，可覆盖 SOLANA_RPC_URL。
预配置值：
- SOLANA_RPC_URL：https://api.mainnet-beta.solana.com
- SOLANA_NETWORK：mainnet-beta
- REQUEST_TIMEOUT：30 秒
- PRIVATE_KEY：需将 REPLACE_THIS 替换为 base58 编码的私钥
备用安装（开发）
用于本地开发或测试：使用 uv 进行依赖管理，通过 .env 文件配置环境变量。
开发与 CI/CD
项目包含与 pre-commit 钩子集成的自动化 DXT 构建：当 dxt/ 文件夹发生更改时自动构建 DXT 文件；始终创建 jupiter-mcp-latest.dxt 以便下载；最新 DXT 文件始终与 main 分支保持同步。也支持手动 DXT 构建与 pre-commit 设置。
测试与安全
项目包含带安全功能的全面测试：
免费测试（默认，不消耗 SOL）：模拟执行测试、API 报价/余额检查、代币搜索与安全检查、错误处理验证。
付费测试（需要 --run-paid-tests 标志）：在 mainnet 上执行真实交易。交换测试使用极小金额（0.0001 SOL ≈ $0.015）。限价订单测试创建高于市场价 20% 的订单，使用 0.04 SOL（≈ $6）以满足最低要求，订单不会在高价成交，验证后自动取消。包含完整交易签名与广播。
测试安全特性：付费测试用 @pytest.mark.paid 明确标记；真实执行使用最小交易金额；限价订单使用不会成交的区间外价格；花费真实资金前有明确警告；交易确认附带区块链签名。
安全说明
- 私钥永不离开本机。
- 所有 API 调用使用 HTTPS。
- 切勿将 .env 文件提交到版本控制。
故障排查
- "PRIVATE_KEY environment variable is required"：将 env.example 复制为 .env 并设置私钥。
- "Invalid PRIVATE_KEY format"：使用 base58 编码的私钥（从 Phantom 钱包导出）。
- 连接超时：尝试不同的 RPC URL 或增加 REQUEST_TIMEOUT。
限制
文档未提供关于支持平台范围、收费价格细则、性能指标或地区可用性的进一步说明，这些内容暂未提供。
