项目简介

Jupiter MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 客户端（如 Claude）提供访问 Solana 区块链上 Jupiter 协议 Swap 功能的桥梁。通过此服务器，Claude 可以安全、便捷地调用 Jupiter 的 API，实现代币交换等操作。

主要功能点

获取 Jupiter 报价 (jupiter_get_quote): 允许 Claude 查询 Jupiter 交易所的代币兑换报价。
执行 Jupiter 交换 (jupiter_execute_swap): 允许 Claude 使用配置的 Solana 钱包私钥自动执行代币交换交易。

安装步骤

通过 npm 安装 (推荐)

打开终端，运行以下命令全局安装 'jupiter-mcp-server':

npm install -g jupiter-mcp-server

安装完成后，即可在终端中使用 'jupiter-mcp-server' 命令启动服务器。

从源代码安装

克隆 GitHub 仓库到本地:

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

安装项目依赖:
```
npm ci
```
构建项目:
```
npm run build
```
（可选）全局安装本地版本，方便直接使用 'jupiter-mcp-server' 命令启动:
```
npm install -g ./
```

服务器配置

要将 Jupiter MCP Server 配置到 MCP 客户端（例如 Claude Desktop），您需要编辑客户端的配置文件，添加服务器的启动信息。以下是针对 Claude Desktop 的配置示例，您需要根据您的安装方式选择合适的配置，并将配置信息添加到 Claude Desktop 的配置文件 'claude_desktop_config.json' 中。

注意： 以下配置中的 'server name' 字段为 'jupiter-mcp-server'，'command' 和 'args' 字段用于指定服务器的启动命令。MCP 客户端会使用这些信息来启动并连接到 MCP 服务器。

通过 npm 安装的配置

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "jupiter-mcp-server",
      "args": [],
      "env": {
        "SOLANA_PRIVATE_KEY": "your_private_key_in_base58_format",
        "SOLANA_RPC_ENDPOINT": "https://api.mainnet-beta.solana.com",
        "SOLANA_NETWORK": "mainnet-beta",
        "LOG_LEVEL": "info"
      }
    }
  }
}

从源代码安装的配置

如果您选择从源代码安装，并希望运行本地构建的版本，请使用以下配置，并替换 '/path/to/your/jupiter-mcp-server' 为您本地仓库的实际路径：

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/your/jupiter-mcp-server/build/index.js"
      ],
      "env": {
        "SOLANA_PRIVATE_KEY": "your_private_key_in_base58_format",
        "SOLANA_RPC_ENDPOINT": "https://api.mainnet-beta.solana.com",
        "SOLANA_NETWORK": "mainnet-beta",
        "LOG_LEVEL": "info"
      }
    }
  }
}

配置参数说明 (env 字段):

'SOLANA_PRIVATE_KEY': (可选，但自动执行 Swap 交易必需) 您的 Solana 钱包私钥，Base58 格式。
'SOLANA_RPC_ENDPOINT': (可选) Solana RPC 节点 URL，默认为 'https://api.mainnet-beta.solana.com'。
'SOLANA_NETWORK': (可选) Solana 网络环境，可选 'mainnet-beta', 'testnet', 'devnet'，默认为 'mainnet-beta'。
'LOG_LEVEL': (可选) 日志级别，可选 'error', 'warn', 'info', 'debug'，默认为 'info'。

重要提示: 请谨慎配置 'SOLANA_PRIVATE_KEY'，确保您的私钥安全。

基本使用方法

启动服务器: 在终端中运行 'jupiter-mcp-server' (如果全局安装) 或 'node build/index.js' (如果从源代码安装)。
配置 MCP 客户端: 将上述服务器配置添加到您的 MCP 客户端配置文件中，并重启客户端。
与 Claude 交互 (示例): 在 Claude 中，您可以询问以下问题来使用 Jupiter Swap 功能：
- "What's the quote for swapping 1 SOL to USDC?" (查询 1 SOL 兑换 USDC 的报价)
- "Execute a swap of 0.1 SOL to USDC." (自动执行 0.1 SOL 兑换 USDC 的 Swap 交易，需要配置私钥)
Claude 将会调用 Jupiter MCP Server 提供的工具来处理您的请求。

关键词