Solana MCP Server 使用说明

项目简介

Solana MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，它充当 LLM (如 Claude) 与 Solana 区块链之间的桥梁。通过预定义的工具，LLM 可以安全、便捷地查询 Solana 网络数据和执行交易，扩展了 LLM 在 Web3 领域的应用能力。

主要功能点

查询最新区块高度 (getSlot): 获取 Solana 区块链的最新区块高度，帮助 LLM 了解链上状态。
查询账户余额 (getBalance): 查询指定 Solana 地址的账户余额，以 SOL 为单位返回。
查询账户详细信息 (getAccountInfo): 获取指定 Solana 地址的详细账户信息，包括所有者、数据、余额等，支持多种数据编码格式。
查询密钥对信息 (getKeypairInfo): 根据私钥获取密钥对的公钥、余额、账户程序所有者等信息，方便 LLM 理解和验证密钥。
SOL 转账 (transfer): 允许 LLM 指示进行 SOL 转账操作，从指定私钥控制的账户转移 SOL 到目标地址。（请务必在测试环境下使用，并仅使用少量资金)

安装步骤

克隆仓库:

git clone https://github.com/akc2267/solana-mcp-server.git
cd solana-mcp-server

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 Solana MCP Server 集成到 MCP 客户端 (例如 Claude)，您需要配置客户端的 'claude_desktop_config.json' 文件。添加以下配置信息，将 'command' 和 'args' 替换为 Solana MCP Server 的实际路径：

{
  "servers": [
    {
      "name": "solana-rpc",  // 服务名称，在 Claude 中用于引用
      "command": "node",     // 运行服务器的命令，这里使用 Node.js
      "args": [             // 命令参数
        "/PATH/TO/solana-mcp-server/build/index.js" //  指向编译后的服务器入口文件，请替换为实际路径
      ]
    }
  ]
}

注意: 请将 '/PATH/TO/solana-mcp-server' 替换为您本地 Solana MCP Server 仓库的绝对路径。

基本使用方法

配置完成后，在 MCP 客户端 (如 Claude) 中，您可以使用自然语言指令调用 Solana MCP Server 提供的工具。以下是一些示例：

查询最新区块高度:

whats the latest slot on solana?

查询账户余额:

whats the balance of 62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3?

转账 SOL (测试环境!):
```
Here's my test key [REPLACE WITH SECRET KEY]. let's transfer 0.001 SOL to [REPLACE WITH PUBLIC ADDRESS]
```
重要安全提示: 进行转账操作时，请务必使用测试钱包的私钥，并仅存入少量 SOL 用于测试。避免在主钱包或高价值钱包上使用此工具，以防资金损失。私钥请替换 '[REPLACE WITH SECRET KEY]' 为你的测试私钥 (Base58 编码或数字数组格式)，公钥地址替换 '[REPLACE WITH PUBLIC ADDRESS]'。

网络配置

默认情况下，服务器连接到 Solana 主网 'https://api.mainnet-beta.solana.com'。如果您需要连接到其他网络（如 devnet 或 testnet），请修改 'src/index.ts' 文件中的 'SOLANA_RPC' 常量。

关键词