Jupiter MCP Server

Jupiter MCP 服务

此代码仓库包含一个 Model Context Protocol（MCP）服务，可让 Claude 访问 Jupiter 的 Portfolio API 和 Price API。该服务使 Claude 能够查看投资组合持仓、跟踪质押的 JUP 代币，并获取 Solana 区块链上的实时代币价格。

概览

此 MCP 服务向 Claude 提供了多个工具：

投资组合工具

• jupiter_get_positions：获取投资组合持仓，包括钱包余额、质押持仓、流动性池、收益耕作、金库、借贷等
• jupiter_get_staked_jup：获取质押的 JUP 代币和解除质押持仓的信息
• jupiter_get_platforms：获取所有与 Jupiter 投资组合跟踪集成的 DeFi 平台列表

价格工具

• jupiter_get_price：获取一个或多个代币的当前价格，包括美元价格、24 小时价格变动和代币小数位数

API 实现

此服务使用 Jupiter API：

• Portfolio API v1（https://api.jup.ag/portfolio/v1）用于投资组合跟踪和分析
• Price API v3（https://api.jup.ag/price/v3）用于实时代币定价

这两个 API 都需要 Jupiter Portal 提供的 API 密钥。

前提条件

• Node.js（v16 或更高版本）
• Claude 桌面应用
• Jupiter API 密钥 - 请访问 https://portal.jup.ag/ 获取

安装

从 npm 安装（推荐）

# Install globally
npm install -g jupiter-mcp-server

# Or use with npx
npx jupiter-mcp-server

从源代码安装

1. 克隆此代码仓库：

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

2. 安装依赖项：

   npm ci
   

3. 构建项目：

   npm run build
   

4. 全局安装（可选）：

   npm install -g ./
   

配置

配置 Claude Desktop

要配置 Claude Desktop 使用此 MCP 服务：

1. 打开 Claude Desktop

2. 找到 Claude Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\\Claude\\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. 添加 MCP 服务配置：

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "npx",
      "args": ["jupiter-mcp-server"],
      "env": {
        "JUPITER_API_KEY": "your_jupiter_api_key_from_portal"
      }
    }
  }
}

如果你是从源代码安装的，并且想运行本地版本，请使用：

{
  "mcpServers": {
    "jupiter-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/your/jupiter-mcp-server/build/index.js"
      ],
      "env": {
        "JUPITER_API_KEY": "your_jupiter_api_key_from_portal"
      }
    }
  }
}

环境变量说明

• JUPITER_API_KEY（必需）：你的 Jupiter API 密钥，可从 https://portal.jup.ag/ 获取

替代方案：使用 .env 文件

如果你直接运行服务（而非通过 Claude Desktop 运行），可以在根目录中创建 .env 文件：

JUPITER_API_KEY=your_jupiter_api_key_from_portal

本地运行

# If installed globally
jupiter-mcp-server

# If installed from source
node build/index.js

# Using npx
npx jupiter-mcp-server

使用方法

配置完成后，重启 Claude Desktop。Claude 现在即可使用 Jupiter 投资组合和价格工具。你可以向 Claude 提出以下请求：

投资组合操作

1. 查看投资组合持仓：

   Show me the portfolio for address YOUR_WALLET_ADDRESS
   

2. 查看质押的 JUP：

   How much JUP is staked for address YOUR_WALLET_ADDRESS?
   

3. 列出可用平台：

   What platforms are supported for portfolio tracking?
   

价格操作

4. 获取代币价格：

   What's the current price of SOL and USDC?
   

5. 获取多个代币的价格：

   Get prices for these tokens: So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
   

故障排除

API 身份验证问题

如果遇到 401 Unauthorized 错误：

1. 确认已在环境变量中正确设置 JUPITER_API_KEY
2. 确保 API 密钥有效 - 你可以从 https://portal.jup.ag/ 获取新密钥
3. 检查 API 密钥前后是否有多余的空格或引号

开发

添加新工具

要向 MCP 服务添加新工具：

1. 在 src/tools.ts 中定义工具
2. 在相应的处理程序文件中创建处理函数
3. 将处理函数添加到 src/tools.ts 中的 handlers 对象

构建

npm run build

测试

npm test

发布到 npm

确保已登录 npm：

npm login

然后发布软件包：

npm publish

要发布新版本，请先更新 package.json 中的版本：

npm version patch  # or minor, or major
npm publish

许可证

MIT

支持项目

如果 Jupiter MCP 服务对你有帮助，可以考虑赞助其开发。

你的支持有助于保持与 Jupiter API 的兼容性、添加新的 MCP 工具并改进文档。