SolanaViz MCP Server

SolanaViz MCP サーバー

自然言語での会話を通じて、Claude が Solana ブロックチェーンのデータにアクセスし、分析、可視化できる Model Context Protocol（MCP）サーバーです。

特長

• データ分析：Solana ブロックチェーンのデータ、トークン、ウォレット情報を取得して分析します
• 可視化：データ探索に役立つテキストベースの可視化を生成します
• 価格予測：AI によるトークンの価格予測を行います
• セキュリティ分析：トークンやプロトコルのセキュリティリスクを評価します
• 複数ウォレット対応：ご自身のウォレットを含む、任意の Solana ウォレットを分析します

前提条件

• Node.js 18+
• npm または pnpm
• Claude Desktop（MCP サーバーの使用に必要）
• API キー：
  • BirdEye
  • CoinGecko
  • Allora
  • Helius（Solana RPC プロバイダー）

インストール

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

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

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

npm install
# or
pnpm install

3. プロジェクトをビルドします：

npm run build
# or
pnpm build

設定

1. ルートディレクトリに .env ファイルを作成し、次の環境変数を設定します（または .env.example からコピーします）：

BIRDEYE_API_KEY=your_birdeye_api_key
COINGECKO_API_KEY=your_coingecko_api_key
ALLORA_API_KEY=your_allora_api_key
HELIUS_RPC_URL=your_helius_rpc_url
DEFAULT_WALLET_ADDRESS=optional_default_wallet_address

2. Claude Desktop アプリケーションのデータディレクトリに claude_desktop_config.json ファイルを作成し、MCP サーバーを使用するよう Claude Desktop を設定します：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

/path/to/GOATsolana-mcp をプロジェクトの絶対パスに置き換えて、次の内容を追加します：

{
  "mcpServers": {
    "solana-viz-mcp": {
      "command": "node",
      "args": ["--input-type=module", "/path/to/GOATsolana-mcp/build/index.js"],
      "env": {
        "BIRDEYE_API_KEY": "your_birdeye_api_key",
        "COINGECKO_API_KEY": "your_coingecko_api_key",
        "ALLORA_API_KEY": "your_allora_api_key",
        "HELIUS_RPC_URL": "your_helius_rpc_url",
        "DEFAULT_WALLET_ADDRESS": "optional_default_wallet_address"
      }
    }
  }
}

重要：Node.js が ES モジュールを正しく読み込むには、--input-type=module フラグが不可欠です。このフラグがないと、ファイルが存在していても Claude Desktop で「Cannot find module」エラーが発生します。

3. テストのためにサーバーを直接起動します：

npm start

4. 設定を変更した後は、Claude Desktop を完全に再起動してください。

重要な注意事項

モジュールの読み込み

このプロジェクトでは、CommonJS（require/module.exports）ではなく ES モジュール（import/export）を使用しています。Claude Desktop の設定には、Node.js がモジュールを正しく読み込むために不可欠な --input-type=module フラグが含まれています。

モック実装

現在の実装では、一部の GOAT SDK プラグインにモック実装を使用しています。これは、プラグイン API とコードで想定されるインターフェースに不一致があるためです。今後のアップデートで、これらのモックを実際の実装用アダプターに置き換える予定です。

利用可能なツール

設定ツール

• set_wallet：分析に使用するアクティブなウォレットアドレスを設定または変更します

データ取得ツール

• get_token_data：トークンの包括的な情報と指標を取得します
• get_wallet_tokens：ウォレットアドレスが保有するトークンを分析します
• get_price_history：トークンの過去の価格データを取得します
• get_token_pairs：DEX 全体の取引ペアを分析します
• get_trending_tokens：現在 Solana でトレンドになっているトークンを特定します

予測ツール

• get_price_prediction：AI によるトークンの価格予測を生成します

セキュリティツール

• get_token_security：トークンやプロトコルのセキュリティリスクを評価します

可視化ツール

• generate_sankey_diagram：エンティティ（トークン、プロトコル、ウォレット）間のフローを可視化します
• generate_treemap：入れ子状の長方形で階層データを可視化します
• generate_heatmap：カテゴリ全体のデータの強度を可視化します
• generate_network_graph：エンティティ間の関係やつながりを可視化します
• generate_radar_chart：複数のエンティティについて、複数の変数を比較します
• generate_bubble_chart：3 次元データ（x、y、サイズ）を可視化します
• generate_temporal_heatmap：期間ごとのデータパターンを可視化します
• generate_donut_chart：全体に対する各部分の割合を可視化します

使用例

Claude で SolanaViz MCP を使用する方法の例をいくつか紹介します：

ウォレットを設定して保有資産を分析する

Please set my wallet address to FtG3emhAqBC8Rr9vdCqTJHxaNNuQVt7B7HvujJrQEj7Y and analyze what tokens I'm holding.

セキュリティ分析を含むトークン情報を取得する

Can you tell me more about the BONK token? Is it secure to invest in?

市場のトレンドを分析する

What are the trending tokens on Solana right now? Can you show me their price performance?

ポートフォリオの配分を可視化する

Analyze my wallet and visualize my portfolio allocation as a donut chart.

価格予測を取得する

What's your price prediction for SOL token in the next 24 hours?

出力例

Claude を通じて各種ツールを使用する際に表示される出力例を紹介します。

データ取得の例

トークンデータ

BONK などのトークンについて質問した場合：

The BONK token (address: DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263) has the following details:

📊 Market Data:
• Current Price: $0.00002981
• Market Cap: $294,152,890
• 24h Volume: $26,843,751
• 24h Change: +7.3%
• All-time High: $0.00003241 (Jan 05, 2024)

💰 Token Economics:
• Total Supply: 99,508,123,523,595
• Circulating Supply: 56,123,876,231,175
• Holders: 842,391 addresses
• Top 10 Holders Control: 47.2% of supply

🔍 Security Analysis:
• Rugpull Risk: Low
• Contract Audit: Passed (Certik)
• Liquidity Score: 9.2/10
• Community Trust: High
• Risk Assessment: Medium

ウォレットのトークン分析

ウォレットの保有資産を分析するよう依頼した場合：

Wallet FtG3emhAqBC8Rr9vdCqTJHxaNNuQVt7B7HvujJrQEj7Y contains the following tokens:

1. SOL
   • Amount: 12.45 SOL
   • Value: $1,431.75
   • % of Portfolio: 68.2%

2. BONK
   • Amount: 13,521,340.93 BONK
   • Value: $402.87
   • % of Portfolio: 19.2% 

3. JTO
   • Amount: 38.72 JTO
   • Value: $264.15
   • % of Portfolio: 12.6%

Total Portfolio Value: $2,098.77

価格履歴データ

価格履歴をリクエストした場合：

Price history for SOL over the last 30 days:

Date        | Price (USD) | 24h Volume  | Market Cap
------------|-------------|-------------|-------------
2025-03-15  | $115.32     | $1.42B      | $49.73B
2025-03-08  | $109.78     | $1.27B      | $47.38B
2025-03-01  | $103.65     | $1.15B      | $44.73B
2025-02-22  | $114.21     | $1.33B      | $49.27B
2025-02-15  | $95.83      | $0.98B      | $41.35B

The token has shown an overall upward trend with a 20.3% increase over the past 30 days, despite some volatility in the middle of the period.

セキュリティ分析

トークンのセキュリティについて質問した場合：

Security Analysis for BONK token (DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263):

✅ Contract Analysis:
• No backdoor functions detected
• No proxy implementation risks
• No excessive owner privileges
• No unusual fee mechanisms

⚖️ Liquidity Analysis:
• Total Liquidity: $18.52M across 5 DEXes
• Largest Pool: Raydium SOL/BONK with $7.82M
• Liquidity Concentration Score: 8.4/10 (Well distributed)

🔍 Ownership Structure:
• Creator Ownership: 12% (vested over 3 years)
• DAO Treasury: 18%
• Community Allocation: 70%

⚠️ Risk Factors:
• Meme token volatility
• Significant social media influence on price
• High correlation with overall market sentiment

🔐 Overall Security Score: 8.2/10 (Low Risk)

可視化の例

ドーナツグラフ

ポートフォリオの配分を可視化するよう依頼した場合：

Portfolio Allocation for FtG3emhAqBC8Rr9vdCqTJHxaNNuQVt7B7HvujJrQEj7Y

       ╭───────────────────────────╮
      /      SOL 68.2%              \
     /          ████████████████     \
    |           ████████████████      |
    |           ████████████████      |
    |  BONK     ████████████████  JTO |
    | 19.2% ███ ████████████████ ███  |
     \      ███ ████████████████ ███ /
      \     ███                  ███/
       ╰───███───────────────────███╯
               12.6%
               
Total Portfolio Value: $2,098.77

ヒートマップ

複数の時間枠にわたるトークンのパフォーマンスを可視化するよう依頼した場合：

Token Performance Heatmap (% Change)

           | 24h    | 7d     | 30d    | 90d    |
-----------+--------+--------+--------+--------|
SOL        | +3.2%  | +12.5% | +20.3% | +65.7% |
BONK       | +7.3%  | -3.8%  | +41.2% | +18.5% |
JTO        | -1.5%  | +5.7%  | +9.2%  | +32.1% |
PYTH       | +2.7%  | +8.2%  | +15.7% | +27.5% |
RENDER     | +0.5%  | -2.3%  | +11.3% | +42.8% |

Legend: █ >30%  █ 10-30%  █ 0-10%  █ -10-0%  █ <-10%

ネットワークグラフ

トークン間の関係を可視化する場合：

Network Graph: Solana DeFi Token Relationships

                     ┌────────┐
                     │  SOL   │
                     └────────┘
                         │
          ┌──────────────┼──────────────┐
          │              │              │
    ┌─────▼─────┐  ┌─────▼─────┐  ┌─────▼─────┐
    │   BONK    │  │   USDC    │  │    JTO    │
    └─────┬─────┘  └─────┬─────┘  └─────┬─────┘
          │              │              │
      ┌───▼───┐      ┌───▼───┐      ┌───▼───┐
      │  wBTC │      │  ETH  │      │ PYTH  │
      └───────┘      └───────┘      └───────┘

Legend:
- Node size represents market cap
- Edge thickness represents liquidity between tokens

サンキーダイアグラム

トークンの流れを可視化する場合：

Sankey Diagram: Token Flow Between Major Wallets (Last 7 Days)

   Exchange Wallets                         DeFi Protocols
┌───────────────────┐                   ┌─────────────────────┐
│                   │  12,500 SOL       │                     │
│     Binance       ├───────────────────► Marinade Finance    │
│                   │                   │                     │
└───────────────────┘                   └─────────────────────┘
                                                 │
┌───────────────────┐                            │ 9,300 SOL
│                   │  7,800 SOL         ┌───────▼─────────────┐
│     Coinbase      ├────────────────────►                     │
│                   │                    │     Orca Pools      │
└───────────────────┘                    │                     │
                                         └─────────────────────┘
┌───────────────────┐                            ▲
│                   │  15,200 SOL                │
│      Kraken       ├────────────────────────────┘
│                   │
└───────────────────┘

API キーの取得

必要な API キーの取得方法は次のとおりです。

• BirdEye API Key：birdeye.so で登録します
• CoinGecko API Key：coingecko.com/en/api で登録します
• Allora API Key：allora.ai で登録します
• Helius RPC URL：helius.dev で登録します

プロジェクト構成

プロジェクトは次のように構成されています。

• src/：MCP サーバーのソースコード
  • index.ts：サーバーのメインエントリーポイント
  • tools/：各種機能のツール実装
  • utils/：ユーティリティ関数とヘルパー
  • types/：TypeScript の型定義
• build/：コンパイル済み JavaScript コード（npm run build の実行後に生成）
• .env：API キーの環境変数
• claude_desktop_config.json：Claude Desktop の設定

制限事項

• 無料プランの API キーにはレート制限があり、機能に影響する場合があります
• プレミアム API アクセスがない場合、一部のツールでは機能が制限されることがあります
• 現在の実装では、一部の API にモックプラグインを使用しています
• トランザクションの実行には対応していません。セキュリティ上、サーバーは読み取り専用です

トラブルシューティング

Cannot Find Module エラー

Claude Desktop で「Cannot find module」エラーが発生した場合は、次の点を確認してください。

• claude_desktop_config.json 内の index.js ファイルへのパスが正しいこと
• --input-type=module フラグが args 配列に含まれていること
• npm run build でプロジェクトを再ビルドしたこと
• Claude Desktop を完全に再起動したこと

API キーの問題

API エラーによってツールが動作しない場合：

• .env と claude_desktop_config.json の両方で API キーが正しく設定されていることを確認します
• API の無料プランにレート制限がないか確認します
• 大文字と小文字が正しいことを確認します（特に BirdEye API キー）

ライセンス

MIT

謝辞

このプロジェクトは、以下を使用して構築されました。

• Crossmint による GOAT SDK
• Anthropic による Model Context Protocol