Solscan MCP Server

🚀 Solscan MCP サーバー

このサーバーは、Solscan Pro API と対話するための Model Context Protocol (MCP) サービスの実装です。AI エージェントが Solana ブロックチェーンのトークン、取引、DeFi 活動データを取得し分析できるようにします。

🚀 クイックスタート

この MCP サーバーは、AI エージェントと Solscan Pro API サービスの間の橋渡しを行います。Anthropic が提唱するベストプラクティスに準拠しており、すべての MCP 互換クライアントとのシームレスな統合をサポートしています。

✨ 主な機能

このサーバーは、Solscan と対話するための様々なツールを提供します。

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

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

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

   • 取引ペアと流動性プールを表示
   • プログラムアドレスでフィルタリング
   • 結果を並べ替えてページング

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

   • 保有者の残高と分布状況を表示
   • 金額範囲でフィルタリング
   • 結果をページングで表示

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

   • 過去の価格データを取得
   • 日付範囲でフィルタリング
   • 価格トレンドと統計情報を取得

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

   • トークンと NFT の保有状況をリスト表示
   • 残高がゼロのものをフィルタリング
   • 結果をページングで表示

6. defi_activities：DeFi 活動情報を取得

   • DeFi 関連の操作記録を取得
   • タイプでフィルタリング
   • 結果を並べ替えてページング

7. transaction：取引情報を取得

   • ウォレットに関連する取引詳細を取得
   • ブロック高または時間範囲でフィルタリング
   • 取引ハッシュと入出力の詳細を表示

📦 インストール

使用条件

• Python 3.8 以上が必要
• Solscan Pro API のキーを取得する必要があります
• Docker を使用してサービスを実行することを推奨

インストール方法

使用 uv

uv pip install solscan-mcp-server

使用 pip

pip install solscan-mcp-server

📚 ドキュメント

設定

以下はサーバーの設定オプションです。

サーバーの実行

使用 uv

uv solscan-mcp-server --api-key=your_api_key_here

使用 Docker

docker run -it --rm -e SOLSCAN_API_KEY=your_api_key_here solscan/mcp-server

統合

Claude Desktop の設定

~/.config/claude/settings.json に以下を追加します。

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

Zed の設定

~/.config/zed/settings.json に以下を追加します。

"inspector.servers": {
  "solscan": {
    "command": {
      "path": "uvx",
      "args": ["solscan-mcp-server"]
    }
  }
}

開発

テストの実行

uv pip install -e ".[dev]"
pytest

コード品質チェック

pyright
ruff check .

デバッグ

MCP モニターを使用してデバッグします。

npx @modelcontextprotocol/inspector uvx solscan-mcp-server

🤝 貢献

貢献を歓迎します！Pull Request をいつでも提出してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されています。詳細は LICENSE ファイルを参照してください。