Jupiter Solana Mcp Server

Jupiter MCP Server

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 トークンを含む、UI で扱いやすい金額で表示された完全なポートフォリオ概要。

3. get-ultra-order

DEX ルーティングと RFQ を組み合わせた、Jupiter の Ultra API による最適化済みスワップ注文を取得します。

入力：

• inputMint：入力トークンのミントアドレス
• outputMint：出力トークンのミントアドレス
• amount：入力金額（文字列、例："1.23"）
• slippageBps：スリッページ許容値（ベーシスポイント単位、例：0.5% の場合は 50）

戻り値：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. リポジトリをフォークします
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 Developer Documentation
• Solana のドキュメント：Solana Developer Documentation