pumpfun-mcp

pumpfun-mcp

Solana 上の Pump.fun プラットフォームを操作するための Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、AI アシスタントから Pump.fun プラットフォームでトークンを作成、購入、売却できます。

使い方

https://github.com/user-attachments/assets/0b0f1f6f-6ea6-4ca8-92a8-b4cc895814e4

このサーバーを Claude や、その他の MCP 対応 AI アシスタントで使用するには、次の設定を MCP クライアントに追加します。

MacOS を使用していて、Claude Desktop で実行する場合は、~/Library/Application \Support/Claude/claude_desktop_config.json ファイルに次の内容を記述してください。

{
  "mcpServers": {
    "pumpfun": {
      "command": "node",
      "args": ["/Users/noahsolomon/Desktop/pumpfun-mcp/build/index.js"], // note this should be YOUR absolute path to index.js, not mine.
      "env": {
        "HELIUS_RPC_URL": "https://your-helius-rpc-url.com"
      }
    }
  }
}

https://your-helius-rpc-url.com を、ご自身の Helius RPC URL に置き換えてください。

インストール

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

   git clone https://github.com/noahgsolomon/pumpfun-mcp.git
   cd pumpfun-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. Solana RPC URL を指定した .env ファイルを作成します。

   HELIUS_RPC_URL=https://your-helius-rpc-url.com
   

   Helius から無料の RPC URL を取得できます。

   既存の Solana ウォレットを使用するには、秘密鍵を .env ファイルに追加します。

   PRIVATE_KEY=your-base58-encoded-private-key
   

   次に、変換スクリプトを実行してキーペアファイルを作成します。

   node convert-key.js
   

   .keys フォルダーに、キーペアを含む default.json ファイルが作成されます。

4. プロジェクトをビルドします。

   npm run build
   

5. MCP サーバーを実行します。

   node build/index.js
   

コンポーネント

ツール

• get-token-info

  • Pump.fun トークンの情報を取得します。
  • 入力パラメーター：
    • tokenAddress（string、必須）：トークンのミントアドレス

• create-token

  • 新しい Pump.fun トークンを作成します。
  • 入力パラメーター：
    • name（string、必須）：トークン名
    • symbol（string、必須）：トークンのシンボル
    • description（string、必須）：トークンの説明
    • imageUrl（string、任意）：ローカル画像ファイルへのパス
    • initialBuyAmount（number、必須）：SOL での初回購入額（最小 0.0001）
    • accountName（string、任意）：使用するアカウント名（デフォルトは "default"）

• buy-token

  • Pump.fun トークンを購入します。
  • 入力パラメーター：
    • tokenAddress（string、必須）：トークンのミントアドレス
    • buyAmount（number、必須）：SOL での購入額（最小 0.0001）
    • accountName（string、任意）：使用するアカウント名（デフォルトは "default"）
    • slippageBasisPoints（number、任意）：スリッページ許容値（ベーシスポイント単位。デフォルトは 100）

• sell-token

  • Pump.fun トークンを売却します。
  • 入力パラメーター：
    • tokenAddress（string、必須）：トークンのミントアドレス
    • sellAmount（number、必須）：売却するトークンの数量（すべて売却する場合は 0 を指定）
    • accountName（string、任意）：使用するアカウント名（デフォルトは "default"）
    • slippageBasisPoints（number、任意）：スリッページ許容値（ベーシスポイント単位。デフォルトは 100）

• list-accounts

  • .keys フォルダー内のすべてのアカウントを一覧表示します。
  • 入力パラメーターは不要です。

• get-account-balance

  • アカウントの SOL とトークンの残高を取得します。
  • 入力パラメーター：
    • accountName（string、任意）：確認するアカウント名（デフォルトは "default"）
    • tokenAddress（string、任意）：残高を確認するトークンのアドレス

アカウント管理

MCP は .keys フォルダー内に Solana のキーペアを自動的に作成、管理します。各キーペアは、アカウント名をファイル名とする JSON ファイルとして保存されます。

トークンの作成時には、ミントキーペアも .keys フォルダーに mint- というプレフィックスを付けて保存されます。

MCP を自身のアカウントで使用するには、次の操作が必要です。

1. 秘密鍵を .env ファイルに追加し、node convert-key.js を実行します。
2. そのウォレットに十分な SOL を保有していることを確認します。

スタンドアロンスクリプト

プロジェクトには、直接実行できるスタンドアロンスクリプトがいくつか含まれています。

• トークン情報の取得：node build/get-token-info.js <token_address>
• トークンの作成：node build/create-token.js <name> <symbol> <description> <initial_buy_amount> [account_name] [image_url]
• トークンの購入：node build/buy-token.js <token_address> <buy_amount_sol> [account_name] [slippage_basis_points]
• トークンの売却：node build/sell-token.js <token_address> <sell_amount> [account_name] [slippage_basis_points]
• アカウント一覧の取得：node build/list-accounts.js
• アカウント残高の取得：node build/get-token-balance.js <account_name> [token_address]

重要な注意事項

• セキュリティ：キーペアは.keysフォルダーに暗号化されずに保存されます。このフォルダーは適切に保護してください。
• 手数料：Solana上のすべてのトランザクションには、トランザクション手数料としてSOLが必要です。アカウントに十分なSOLがあることを確認してください。
• スリッページ：デフォルトのスリッページ許容度は1％（100ベーシスポイント）です。トランザクションごとに調整できます。
• 画像：画像付きでトークンを作成する場合は、画像のローカルファイルパスを指定する必要があります。リモートURLには対応していません。

開発

プロジェクト構成

• src/index.ts：メインのMCP サーバーのエントリーポイント
• src/get-token-info.ts：トークン情報の取得
• src/create-token.ts：トークン作成機能
• src/buy-token.ts：トークン購入機能
• src/sell-token.ts：トークン売却機能
• src/list-accounts.ts：アカウント一覧表示機能
• src/get-token-balance.ts：アカウント残高の確認
• src/utils.ts：共有ユーティリティ関数
• convert-key.js：base58秘密鍵をキーペアJSONファイルに変換するユーティリティ

ビルド

npm run build