Pumpfun MCP Server

🚀 ポンプ.fun-MCP

このサーバーは、Pump.fun プラットフォームとSolana上でやり取りするModel Context Protocol（MCP）サーバーです。このサーバーにより、AIアシスタントはPump.funプラットフォーム上でトークンの作成、購入、販売が可能になります。

🚀 クイックスタート

このプロジェクトの詳細な情報や使用方法については、こちらのリンクを参照してください。

💻 使用例

基本的な使用法

Claudeやその他のMCP互換のAIアシスタントを設定するには、以下の手順に従ってください。

1. AIアシスタントの設定画面を開きます。
2. モデルコンテキストプロトコル（MCP）のセクションで、以下の内容を追加します。
3. 以下のパスとコマンドを該当する場所にコピーします。

# サンプルコマンド
cd /path/to/pumpfun-mcp
npm run start -- --token_address your_token_address

📦 インストール

リポジトリのクローン

ターミナルで以下のコマンドを実行して、このプロジェクトをクローンします。

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

依存関係のインストール

プロジェクトに必要な依存関係をインストールします。

npm install

設定ファイルの作成

.env という名前のファイルを作成し、以下の内容を追加してください。Helius RPC URLとMPC手数料アドレスが正しいことを確認してください。

HELIUS_RPC_URL=https://api.helius.dev/v0
MPC_FEE_ADDRESS=So11nWw5LEthHzNHv3s82ohw69jznyrXuYTuojQ7hPFWtv

既存のウォレットの変換

既にSolanaウォレットの秘密鍵を持っている場合は、以下のコマンドを使用して鍵ペアファイルに変換できます。

node convert-key.js --private_key your_private_key_here --account_name your_account_name

📚 ドキュメント

ツール機能

• トークン情報の取得: src/get-token-info.ts - 指定されたトークンの情報を取得します。
• トークンの作成: src/create-token.ts - 新しいトークンを作成し、初期購入価格を設定します。
• トークンの購入: src/buy-token.ts - SOLを使用して指定されたアドレスのトークンを購入します。
• トークンの販売: src/sell-token.ts - 保有しているトークンを販売します。
• アカウントの一覧表示: src/list-accounts.ts - 管理されているすべてのSolanaアカウントを一覧表示します。
• 残高の取得: src/get-token-balance.ts - 指定されたアカウントのSOLとトークンの残高を確認します。

アカウント管理

MCPは自動的にSolanaの鍵ペアを作成し、管理します。これらの鍵ペアは .keys フォルダにJSONファイルとして保存され、各鍵ペアはアカウント名をファイル名として使用します。トークンを作成する際には、生成されたミント鍵ペアも .keys フォルダに mint- 接頭辞付きで保存されます。

使用上の注意事項

1. セキュリティ: .keys フォルダ内の鍵ペアは暗号化されていないため、適切に保管してください。
2. 手数料: すべてのSolanaトランザクションにはSOLが手数料として必要です。アカウントに十分なSOLがあることを確認してください。
3. スリッページ許容度: デフォルトのスリッページ許容度は1%（100ベーシスポイント）です。必要に応じて調整できます。

独立したスクリプト

このプロジェクトには、直接実行できる独立したスクリプトが用意されています。

• トークン情報の取得: 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]

開発ガイド

プロジェクト構造

• 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

テストの実行

テストスクリプトを実行するには、すべての依存関係がインストールされていることを確認してから、以下のコマンドを実行します。

npm test

貢献ガイド

貢献を歓迎します！このプロジェクトに貢献する方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT License によって保護されています。