solscan_mcp_server

🚀 Solscan MCP 服务器

Solscan MCP 服务器是一个用于与 Solscan Pro API 交互的 Model Context Protocol (MCP) 服务实现。它允许 AI 代理获取并分析来自 Solana 区块链的代币、交易和 DeFi 活动数据，为区块链数据的分析和利用提供了便利。

🚀 快速开始

Solscan 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

📚 详细文档

配置

以下为服务器的配置选项： | 选项 | 环境变量名 | CLI 参数名 | 默认值 | | ---- | ---- | ---- | ---- | | API 密钥 | SOLSCAN_API_KEY | -k, --api-key | 必填 | | 基础 URL | SOLSCAN_BASE_URL | -b, --base-url | https://api.solscan.io | | 请求超时时间 | REQUEST_TIMEOUT | -t, --timeout | 30 | | 最大重试次数 | MAX_RETRIES | -r, --retries | 3 | | 日志级别 | LOG_LEVEL | -l, --log-level | INFO |

运行服务器

使用 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 文件。