使用说明

项目简介

Solana MCP Server 是一个 MCP (Model Context Protocol) 服务器实现,它允许大型语言模型 (LLM) 通过标准化的 MCP 协议与 Solana 区块链进行交互。该服务器提供了一系列工具,使 LLM 能够获取 Solana 链上的信息(如最新的区块高度、钱包余额)以及执行交易(如转账 SOL)。

主要功能点

  • 获取最新区块高度 (get-latest-slot): 查询 Solana 区块链的最新区块高度。
  • 获取钱包地址 (get-wallet-address): 获取配置的私钥对应的钱包地址。
  • 获取钱包余额 (get-wallet-balance): 查询钱包在 Solana 链上的 SOL 余额,并提供 Lamports 和美元计价的余额信息。
  • 转账 SOL (transfer): 向指定的接收地址转账 SOL。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/Grandbusta/solana-mcp.git
    cd solana-mcp
  2. 安装依赖:
    npm install
  3. 构建项目:
    npm run build
  4. 创建私钥文件:
    • 在本地文件系统中创建一个名为 'keypair.json' 的文件(位置任意)。
    • 将你的 Solana 私钥以 JSON 数组的形式复制到 'keypair.json' 文件中。可以参考仓库中的 'example-keypair.json' 文件格式。
    • 注意:请务必妥善保管你的私钥,避免泄露。

服务器配置

要将 Solana MCP Server 集成到 MCP 客户端(例如 Cursor),你需要配置服务器的启动命令。以下是配置信息,你需要将其填入 MCP 客户端的服务器配置中:

{
  "serverName": "Solana MCP",
  "command": "/path/to/your/solana-mcp/run.sh",
  "args": [
    "/path/to/your/keypair.json"
  ]
}

参数说明:

  • 'serverName': 服务器名称,可以自定义,例如 "Solana MCP"。
  • 'command': 服务器启动命令,指向 'run.sh' 脚本的绝对路径。你需要将 '/path/to/your/solana-mcp/run.sh' 替换为你本地 'run.sh' 脚本的实际路径。
  • 'args': 启动命令的参数,以数组形式提供。
    • '/path/to/your/keypair.json': 私钥文件 'keypair.json' 的绝对路径。你需要将其替换为你本地 'keypair.json' 文件的实际路径。

例如,如果你的 'solana-mcp' 仓库克隆在 '/Users/username/projects/solana-mcp' 目录,并且 'keypair.json' 文件位于 '/Users/username/Documents/keypair.json',则配置应如下所示:

{
  "serverName": "Solana MCP",
  "command": "/Users/username/projects/solana-mcp/run.sh",
  "args": [
    "/Users/username/Documents/keypair.json"
  ]
}

运行 'run.sh' 脚本前,请确保该脚本具有执行权限 ('chmod +x run.sh')。

基本使用方法

配置完成后,在 MCP 客户端中,你可以通过以下工具名称调用 Solana MCP Server 提供的功能:

  • 'get-latest-slot': 获取最新区块高度。
  • 'get-wallet-address': 获取钱包地址。
  • 'get-wallet-balance': 获取钱包余额。
  • 'transfer': 转账 SOL,需要提供 'to' (接收地址) 和 'amount' (转账金额) 两个参数。

具体工具的使用方法和参数可以在 MCP 客户端中进一步了解。例如,在 Cursor 中,你可以在聊天框中使用 '@工具名称' 的方式调用工具,并按照提示提供参数。

示例 (在 Cursor 中):

  • '@get-wallet-balance' - 查询钱包余额。
  • '@transfer to=接收方Solana地址 amount=1.5' - 向指定地址转账 1.5 SOL。

注意: Solana MCP Server 默认连接到 Solana devnet 网络。如果你需要连接到其他网络(如 mainnet),请修改 'run.sh' 脚本中的 'RPC_URL' 环境变量。

信息

分类

开发者工具