Solscan MCP Server

Solscan MCP 服务

用于与 Solscan Pro API 交互的模型上下文协议（MCP）服务实现。此服务允许 AI Agent 从 Solana 区块链获取并分析代币、交易和 DeFi 活动数据。

概述

此 MCP 服务为 AI Agent 与 Solscan Pro API 服务之间提供桥接。它遵循 Anthropic 制定的 MCP 服务构建最佳实践，可与任何兼容 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 时无需进行特定安装。我们使用 uvx 直接运行 solscan-mcp-server。

使用 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 inspector 调试服务：

npx @modelcontextprotocol/inspector uvx solscan-mcp-server

开发调试：

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

贡献

欢迎参与贡献！请随时提交 Pull Request。

许可证

本项目采用 MIT License 授权。详情请参阅 LICENSE 文件。