🚀 Solscan MCP 服务器
Solscan MCP 服务器是一个用于与 Solscan Pro API 交互的 Model Context Protocol (MCP) 服务实现。它允许 AI 代理获取并分析来自 Solana 区块链的代币、交易和 DeFi 活动数据，为区块链数据的分析和利用提供了便利。
🚀 快速开始
Solscan MCP 服务器为 AI 代理与 Solscan Pro API 服务之间架起了桥梁。它遵循了 Anthropic 提出的最佳实践，支持与任何 MCP 兼容客户端的无缝集成。
✨ 主要特性
该服务器提供了与 Solscan 交互的多种工具：
token_meta：获取代币元数据- 获取全面的代币信息
- 获取名称、符号、价格、市值等信息
token_markets：获取代币市场数据和流动性池- 查看交易对和流动性池
- 按程序地址过滤
- 排序和分页结果
token_holders：获取代币持有者分布- 查看持有者的余额和分布情况
- 按金额范围过滤
- 分页查看结果
token_price：获取代币价格信息- 获取历史价格数据
- 按日期范围过滤
- 获取价格趋势和统计信息
token_accounts：获取钱包的代币持有情况- 列出代币和 NFT 的持有情况
- 过滤零余额
- 分页查看结果
defi_activities：获取 DeFi 活动信息- 获取与 DeFi 相关的操作记录
- 按类型过滤
- 排序和分页结果
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 文件。