项目简介

Solscan MCP是一个基于Model Context Protocol (MCP) 构建的服务器,它通过集成Solscan API,为LLM客户端提供查询Solana区块链数据的能力。服务器运行后,支持MCP协议的客户端可以连接到该服务器,并利用其暴露的工具来获取关于Solana链上的交易、账户、代币(Token)、NFT、市场和区块等信息。

主要功能点

  • 区块链数据查询: 提供访问Solscan API的各种工具,用于查询Solana链上的实时和历史数据。
  • 代币信息: 获取代币的元数据、市场行情、持有者分布、价格历史等。
  • 账户活动: 查询账户的交易记录、转账详情、DeFi活动、持仓组合等。
  • 交易和区块详情: 查看特定交易的详细信息、最新交易列表、区块详情和区块内的交易列表。
  • NFT数据: 查询最新的NFT信息、NFT活动记录、收藏品列表及其包含的项目。
  • 市场信息: 获取流动池市场列表、市场详细信息和交易量数据。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/Valennmg/solscan-mcp.git
    cd solscan-mcp
  2. 安装Rust: 如果您尚未安装Rust,请访问 rustup.rs 进行安装。
  3. 构建项目:
    cargo build --release
    这将在 'target/release/' 目录下生成可执行文件 'solscan-mcp'。

服务器配置

该服务器是为MCP客户端设计的。为了让支持MCP协议的客户端能够连接并使用此服务器,您需要在客户端配置中指定服务器的启动方式。Solscan MCP服务器依赖于一个环境变量 'SOLSCAN_API_KEY' 来认证Solscan API。

典型的MCP客户端配置(JSON格式)可能包含以下信息:

{
  "name": "Solscan MCP Server",
  "command": "/path/to/your/cloned/repo/target/release/solscan-mcp",
  "args": [],
  "env": {
    "SOLSCAN_API_KEY": "在此处填写您的Solscan API密钥"
  },
  "protocol": "json-rpc",
  "transport": "stdio",
  "description": "一个MCP服务器,通过Solscan API提供Solana链上数据查询能力。"
}
  • 'name': 服务器的名称,用于在客户端中识别。
  • 'command': 服务器可执行文件的绝对路径。请将 '/path/to/your/cloned/repo/' 替换为您实际克隆仓库的路径。
  • 'args': 启动服务器时需要的命令行参数列表(此处为空)。
  • 'env': 服务器运行所需的环境变量,必须包含 'SOLSCAN_API_KEY' 并填入您的有效Solscan API密钥。
  • 'protocol': 使用的协议,对于MCP通常是 'json-rpc'。
  • 'transport': 使用的传输协议,该实现使用了标准输入输出 ('stdio')。
  • 'description': 服务器的简要描述。

基本使用方法

  1. 确保您已设置 'SOLSCAN_API_KEY' 环境变量,或者通过MCP客户端配置中的 'env' 字段传递。
  2. 通过支持MCP协议的客户端(如兼容的LLM应用或终端工具)启动该服务器。客户端会通过标准输入输出与服务器进行JSON-RPC通信。
  3. 一旦连接成功,客户端将能够发现服务器暴露的所有Solscan API工具。LLM客户端可以使用这些工具来查询Solana链上数据,例如通过调用相应的工具查询账户余额、交易状态等,并根据返回的数据生成自然语言响应。

信息

分类

网页与API