Solscan MCP Server

🚀 Solscan MCP 服務器

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

📄 許可證

本項目在 MIT 許可證下開源。具體內容見 LICENSE 文件。