Solana MCP 服务器使用说明

项目简介

Solana MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在为 LLM 客户端提供访问 Solana 区块链数据的能力。通过实现 MCP 协议,该服务器能够以标准化的方式向 LLM 提供上下文信息和功能,使得 LLM 可以便捷地查询和操作 Solana 区块链数据。

主要功能点

  • 资源 (Resources) 管理: 提供对 Solana API 文档等资源的访问。
  • 工具 (Tools) 注册与执行: 支持一系列 Solana RPC 方法,例如:
    • 获取账户信息 (getAccountInfo)
    • 获取账户余额 (getBalance)
    • 获取程序账户 (getProgramAccounts)
    • 获取交易信息 (getTransaction)
    • 查询节点健康状态 (getHealth)
    • 查询节点版本信息 (getVersion)
  • 基于 JSON-RPC 协议通信: 与 MCP 客户端通过 JSON-RPC 协议进行通信,接收请求并返回响应。
  • Stdio 传输协议: 支持 Stdio 作为传输协议,方便集成和部署。

安装步骤

  1. 下载预编译二进制文件 (推荐):

    • 访问 Releases 页面。
    • 根据您的操作系统下载对应的预编译二进制文件,例如 'solana-mcp-server-linux-amd64' (Linux), 'solana-mcp-server-macos-amd64' (macOS Intel), 'solana-mcp-server-macos-arm64' (macOS Apple Silicon), 或 'solana-mcp-server-windows-amd64.exe' (Windows)。
  2. 使二进制文件可执行 (Linux/macOS):

    • 打开终端,导航到您下载的二进制文件所在目录。
    • 运行命令 'chmod +x solana-mcp-server-*' 使文件具有执行权限。
  3. 从源代码构建 (可选):

    • 确保您已安装 Rust 和 Cargo。
    • 克隆仓库到本地:'git clone https://github.com/opensvm/solana-mcp-server.git'
    • 进入仓库目录:'cd solana-mcp-server'
    • 使用 Cargo 构建:'cargo build --release'
    • 构建后的可执行文件位于 'target/release/solana-mcp-server'。

服务器配置

MCP 客户端需要配置 Solana MCP 服务器的启动命令以建立连接。以下是配置信息示例 (JSON 格式),请根据您的实际情况进行配置:

{
  "mcpServers": {
    "solana": {
      "command": "/path/to/solana-mcp-server-*",  // 替换为您的 solana-mcp-server 可执行文件的路径,可以使用预编译版本或自行构建的版本
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"  // (可选) Solana RPC 节点 URL,默认为 "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

配置参数说明:

  • 'server name': 'solana' (服务器名称,可以自定义)
  • 'command': '/path/to/solana-mcp-server-*' (Solana MCP 服务器可执行文件的绝对路径。如果您使用的是预编译版本,请替换为实际的文件路径,例如 '$PWD/solana-mcp-server-linux-amd64', '$PWD' 代表当前目录。如果您是自行构建的,路径为 '$PWD/target/release/solana-mcp-server' )
  • 'env': 环境变量配置
    • 'SOLANA_RPC_URL': (可选) Solana RPC 节点的 URL。如果您有自己的 Solana RPC 节点,可以修改为您的节点地址。如果留空,则默认使用 "https://api.mainnet-beta.solana.com"。

注意: 请将上述 JSON 配置信息添加到您的 MCP 客户端 (例如 Claude Desktop) 的配置文件中。具体的配置文件位置请参考您的 MCP 客户端文档。对于 Claude Desktop,配置文件通常位于 '${XDG_CONFIG_HOME:-$HOME/.config}/claude/config.json'。

基本使用方法

配置完成后,您可以在 MCP 客户端 (例如 Cline) 中使用自然语言与 Solana 区块链进行交互。以下是一些示例查询:

  • "What's the SOL balance of address Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr?" (查询地址 Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr 的 SOL 余额)
  • "Show me the current slot number" (显示当前区块高度)
  • "Get information about the latest block" (获取最新区块的信息)
  • "What's the current inflation rate?" (查询当前的通货膨胀率)
  • "Show me the token accounts owned by address ..." (显示地址 ... 拥有的代币账户)

更多详细的 RPC 方法和使用示例,请参考仓库的 README.md 文件。

信息

分类

网页与API