Jupiter MCP Server

Jupiter MCP Server

このリポジトリには、Claude が Jupiter の Portfolio API と Price API にアクセスできるようにする Model Context Protocol（MCP）サーバーが含まれています。このサーバーを使うと、Claude はポートフォリオのポジションを表示し、ステークされた JUP トークンを追跡し、Solana ブロックチェーン上のトークン価格をリアルタイムで取得できます。

概要

この MCP サーバーは、Claude にいくつかのツールを公開します。

ポートフォリオツール

• jupiter_get_positions：ウォレット残高、ステークされたポジション、流動性プール、ファーミング、ボールト、レンディングなどを含むポートフォリオのポジションを取得します
• jupiter_get_staked_jup：ステークされた JUP トークンとアンステーキング中のポジションに関する情報を取得します
• jupiter_get_platforms：Jupiter のポートフォリオ追跡に統合されているすべての DeFi プラットフォームの一覧を取得します

価格ツール

• jupiter_get_price：USD 価格、24 時間の価格変動、トークンの小数桁数など、1 つ以上のトークンの現在価格を取得します

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 Desktop アプリケーション
• 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 の設定

この MCP サーバーを使用するように Claude Desktop を設定します。

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（必須）：https://portal.jup.ag/ で取得した Jupiter API キーです

別の方法：.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 Server が役に立った場合は、開発へのスポンサーをご検討ください。

ご支援は、Jupiter API との互換性の維持、新しい MCP ツールの追加、ドキュメントの改善に役立ちます。