使用说明

项目简介

这是一个实现了 Model Context Protocol (MCP) 的服务器，旨在使 AI 助手（如 Claude）能够使用 Solana 加密钱包。它使用 Node.js 和 Typescript 构建，可以通过 npx 轻松运行，无需复杂的安装过程。

主要功能点

该 MCP 服务器提供了一系列工具，允许 AI 助手执行以下 Solana 钱包相关操作：

查询余额: 获取指定 Solana 地址或默认钱包的 SOL 余额。
管理 Token 账户: 获取 Solana 地址拥有的 Token 账户列表和指定 Token 账户的余额。
交易操作: 创建、签名和发送 Solana 交易，例如转账 SOL。
密钥管理: 生成新的 Solana 密钥对和导入现有私钥。
地址验证: 验证 Solana 地址的有效性。
交易状态查询: 检查 Solana 交易的确认状态。
网络切换: 支持在 Solana Devnet 和 Mainnet 网络之间切换。
获取当前网络: 查询服务器当前连接的 Solana 网络。

这些功能使得 AI 助手能够安全地与 Solana 区块链进行交互，例如查询用户钱包余额、进行加密货币交易等。

安装步骤

本服务器推荐使用 'npx' 直接运行，无需进行全局安装。

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude）配合使用，您需要在客户端的配置文件中添加服务器的启动配置。以 Claude 为例，您需要在 'claude_desktop_config.json' 文件中配置 'mcpServers' 字段，示例如下：

{
  "mcpServers": {
    "mcp-cryptowallet-solana": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-dockmaster/mcp-cryptowallet-solana"
      ],
      "env": {
        "PRIVATE_KEY": "YOUR_PRIVATE_KEY"  // (可选) 你的 Solana 钱包私钥 (Base58 格式). 如果不提供，服务器将生成新的密钥对。
      }
    }
  }
}

配置参数说明:

'server name': 'mcp-cryptowallet-solana' (服务器名称，客户端用于识别和调用)
'command': 'npx' (启动服务器的命令，这里使用 npx 运行)
'args':
- '-y': (npx 参数，自动确认安装包)
- '@mcp-dockmaster/mcp-cryptowallet-solana': (指定要运行的 npm 包，即本 MCP 服务器)
'env':
- 'PRIVATE_KEY': (可选) Solana 钱包私钥，用于服务器进行交易签名等操作。如果留空，服务器将生成新的密钥对。请务必妥善保管私钥，避免泄露！

基本使用方法

配置完成后，MCP 客户端将能够连接到此服务器。AI 助手可以通过调用服务器提供的各种工具来执行 Solana 钱包操作。例如，要查询钱包余额，AI 助手可以调用 'wallet_get_balance' 工具，并根据工具的参数要求提供 Solana 地址等信息。服务器会将结果以 MCP 响应的格式返回给客户端。

请注意: 本服务器默认使用 Solana Devnet 网络。您可以使用 'wallet_switch_network' 工具切换到 Mainnet 网络。在进行真实资金操作时，请务必切换到 Mainnet 并谨慎操作。

关键词