Jupiter MCP Server

🚀 木星 MCP サーバー

このリポジトリには、モデルコンテキストプロトコル (MCP) サーバーが含まれています。このサーバーは、Claude が Jupiter の交換 API にアクセスできるようにします。このサーバーを使用することで、Claude は Solana ブロックチェーン上で Jupiter を使って、見積もりの取得、交換トランザクションの構築、交換トランザクションの送信などの操作を実行できます。

🚀 クイックスタート

この MCP サーバーは、Claude が Jupiter の交換 API を利用するためのインターフェースを提供します。以下に、サーバーの概要、API の実装、インストール方法、設定方法、使用方法などを説明します。

✨ 主な機能

この MCP サーバーは、Claude に以下のツールを提供します。

• jupiter_get_quote：Jupiter 上で交換トークンの見積もりを取得します。
• jupiter_build_swap_transaction：Jupiter 上で交換トランザクションを構築します。
• jupiter_send_swap_transaction：Jupiter 上で交換トランザクションを送信します。
• jupiter_execute_swap：環境変数に設定されたウォレットの秘密鍵を使用して、完全な交換を実行します。

🔧 技術詳細

このサーバーは Jupiter API を使用しています。

• Lite API v1 (https://lite-api.jup.ag/swap/v1) を使用して交換を実行します。 Lite API は、単一のリクエストで交換を構築して実行するための簡素化されたインターフェースを提供し、信頼性を向上させます。

📦 インストール

npm からのインストール（推奨）

# グローバルインストール
npm install -g jupiter-mcp-server

# または段階的なインストール
npm install --global jupiter-mcp-server

手動インストール

1. ソースコードをダウンロードします。

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

2. 依存関係をインストールし、モジュールをビルドします。

   npm install
   npm run build
   

3. サーバーを起動します。

   node dist/main.js
   

📚 ドキュメント

設定

環境変数の設定

環境変数ファイル（例：.env）に以下の内容を追加します。

LOG_LEVEL=info

JSON 設定ファイル

config.json ファイルを作成または編集します。

{
  "tools": {
    "jupiter_get_quote": {
      "enabled": true,
      "api_key": "your_api_key_here"
    },
    "jupiter_build_swap_transaction": {
      "enabled": true,
      "network": "mainnet-beta"
    }
  }
}

使用方法

新しいツールの追加

MCP サーバーに新しいツールを追加するには、以下の手順を実行します。

1. src/tools.ts でツールを定義します。
2. 適切なハンドラーファイルで対応する処理関数を作成します。
3. src/tools.ts の handlers オブジェクトにハンドラーを追加します。

トラブルシューティング

交換実行中にエラーが発生した場合は、以下の手順で問題を解決してください。

1. 環境変数に LOG_LEVEL=debug を設定して、詳細なログを取得します。
2. 有効な Solana 秘密鍵を提供していることを確認します。
3. ウォレットに交換とトランザクション料金に十分な SOL があることを確認します。
4. 正しい入力と出力トークン識別子を使用していることを検証します。

開発

ローカル開発

1. リポジトリをクローンします。

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

2. 依存関係をインストールし、開発サーバーを起動します。

   npm install
   npm run dev
   

3. 変更をテストします。

   npm test
   

npm への公開

npm にログイン

npm login

その後、パッケージを公開します。

npm publish

新しいバージョンを公開するには、まず package.json のバージョンを更新します。

npm version patch  # または minor、もしくは major
npm publish

📄 ライセンス

MIT