Solscan MCP Server

Solscan MCP サーバー

Solscan Pro API と連携するための、Model Context Protocol（MCP）サーバー実装です。このサーバーを使うと、AI エージェントは Solana ブロックチェーン上のトークン、トランザクション、DeFi アクティビティのデータを取得して分析できます。

概要

この MCP サーバーは、AI エージェントと Solscan Pro API サービスをつなぎます。MCP サーバーの構築に関して Anthropic が定めるベストプラクティスに従っており、MCP 対応クライアントとシームレスに統合できます。

機能

このサーバーは、Solscan と連携するための重要なツールをいくつか提供します。

1. token_meta：トークンのメタデータを取得

   • トークン情報を包括的に取得
   • 名前、シンボル、価格、時価総額などを取得

2. token_markets：トークンの市場データと流動性プールを取得

   • マーケットペアと流動性プールを表示
   • プログラムアドレスで絞り込み
   • 結果を並べ替え、ページネーション

3. token_holders：トークン保有者の分布を取得

   • 保有者の残高と分布を表示
   • 金額の範囲で絞り込み
   • 結果をページネーション

4. token_price：トークンの価格情報を取得

   • 過去の価格データ
   • 日付範囲で絞り込み
   • 価格の推移と統計

5. token_accounts：ウォレットのトークン保有状況を取得

   • トークンと NFT の保有状況を一覧表示
   • 残高がゼロの項目を除外
   • 結果をページネーション

6. defi_activities：ウォレットの DeFi アクティビティを取得

   • アクティビティの種類とプラットフォームで絞り込み
   • 時間やその他の指標で並べ替え
   • アクティビティの詳細を包括的に取得

7. balance_change：残高の変動アクティビティを取得

   • トークン残高の変動を追跡
   • トークンと金額で絞り込み
   • スパムトランザクションを除外

8. account_transactions：ウォレットのトランザクションを取得

   • ウォレットのトランザクションを一覧表示
   • トランザクション履歴をページネーション
   • 結果件数を設定可能

9. transaction_detail：トランザクション情報を取得

   • トランザクションの詳細データ
   • パース済みの命令
   • 手数料情報

10. transaction_actions：トランザクションのアクションを取得

• トークンの送金を一覧表示
• プログラムとのインタラクションを表示
• デコード済みの命令データ

前提条件

• Python 3.10+
• Solscan Pro API キー（Solscan APIsから取得）
• MCP サーバーをコンテナとして実行する場合は Docker（推奨）

インストール

uv を使用する（推奨）

uvを使用する場合、特別なインストールは不要です。solscan-mcp-server を直接実行するためにuvxを使用します。

pip を使用する

代わりに、pip でインストールできます。

pip install solscan-mcp-server

設定

環境変数またはコマンドライン引数を使用してサーバーを設定できます。

オプション	環境変数	CLI 引数	デフォルト	説明
API キー	SOLSCAN_API_KEY	--api-key	必須	Solscan Pro API キー
トランスポート	TRANSPORT	--transport	sse	トランスポートプロトコル（sse または stdio）
ホスト	HOST	--host	127.0.0.1	SSE トランスポート使用時にバインドするホスト
ポート	PORT	--port	8050	SSE トランスポート使用時にリッスンするポート
ログレベル	LOG_LEVEL	--verbose	INFO	ログレベル（詳細を表示するには -v または -vv を使用）

サーバーの実行

uvx を使用する（推奨）

# Using environment variables:
SOLSCAN_API_KEY=your-key uvx solscan-mcp-server

# Using CLI arguments:
uvx solscan-mcp-server --api-key your-key

pip でインストールして使用する

# Using environment variables:
SOLSCAN_API_KEY=your-key python -m solscan_mcp_server

# Using CLI arguments:
python -m solscan_mcp_server --api-key your-key

Docker を使用する

# Build the image
docker build -t solscan-mcp-server .

# Run with environment variables
docker run -e SOLSCAN_API_KEY=your-key solscan-mcp-server

MCP クライアントとの統合

Claude Desktop の設定

uvx を使用する（推奨）

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "solscan": {
      "command": "uvx",
      "args": ["solscan-mcp-server"]
    }
  }
}

pip でインストールして使用する

{
  "mcpServers": {
    "solscan": {
      "command": "python",
      "args": ["-m", "solscan_mcp_server"]
    }
  }
}

Zed の設定

Zed の settings.json に追加します。

"context_servers": {
  "solscan": {
    "command": {
      "path": "uvx",
      "args": ["solscan-mcp-server"]
    }
  }
}

開発

テストの実行

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

コード品質

# Run type checker
pyright

# Run linter
ruff check .

デバッグ

MCP インスペクターを使ってサーバーをデバッグできます。

npx @modelcontextprotocol/inspector uvx solscan-mcp-server

開発時のデバッグ：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳しくは LICENSE ファイルをご覧ください。