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 作为传输协议,方便集成和部署。
安装步骤
-
下载预编译二进制文件 (推荐):
- 访问 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)。
-
使二进制文件可执行 (Linux/macOS):
- 打开终端,导航到您下载的二进制文件所在目录。
- 运行命令 'chmod +x solana-mcp-server-*' 使文件具有执行权限。
-
从源代码构建 (可选):
- 确保您已安装 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