使用说明

项目简介

Solana Model Context Protocol (MCP) Demo 是一个简单的 MCP 服务器示例,专为 Solana 开发人员设计。它提供了一系列工具和资源,旨在帮助开发者更高效地进行 Solana 相关的开发工作,并能与支持 MCP 协议的 LLM 客户端(如 Claude、Windsurf、Cursor)集成,提升开发体验。

主要功能点

  • Solana RPC 工具: 提供与 Solana 网络交互的工具,包括:
    • 'getAccountInfo': 查询 Solana 账户信息。
    • 'getBalance': 查询 Solana 账户余额。
    • 'getTransaction': 查询 Solana 交易详情。
    • 'getMinimumBalanceForRentExemption': 查询租金豁免所需的最小余额。
  • Solana 文档资源: 集成 Solana 官方文档,方便开发者在 LLM 环境中直接访问 Solana 文档内容。
  • Solana 开发 Prompt 模板: 预设了一系列用于 Solana 开发的 Prompt 模板,例如:
    • 计算存储费用。
    • 查询交易失败原因。
    • 分析交易成本。
    • 理解交易内容。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/solana-foundation/solana-dev-mcp.git
    cd solana-dev-mcp
  2. 安装依赖: 确保已安装 Node.js (v16 或更高版本) 和 pnpm 包管理器 (v9.10.0 或兼容版本)。然后运行:
    pnpm install

服务器配置

要将此 Solana MCP 服务器连接到 MCP 客户端,您需要配置客户端以指定服务器的启动命令和参数。以下是 JSON 格式的配置信息,您需要将其添加到您的 MCP 客户端配置中。

如果已全局安装 'ts-node':

{
  "mcpServers": {
    "solana-dev": {
      "command": "ts-node",
      "args": ["<仓库绝对路径>/index.ts"] // 将 <仓库绝对路径> 替换为克隆仓库的实际绝对路径
    }
  }
}

如果未全局安装 'ts-node':

{
  "mcpServers": {
    "solana-dev": {
      "command": "node",
      "args": ["<仓库绝对路径>/dist/index.js"] // 将 <仓库绝对路径> 替换为克隆仓库的实际绝对路径。 首次使用需要先运行 'pnpm build' 构建项目。
    }
  }
}

注意: 请将 '<仓库绝对路径>' 替换为您克隆 'solana-dev-mcp' 仓库的实际文件系统路径。

基本使用方法

  1. 启动 MCP 服务器: 根据您的配置选择,在仓库目录下运行以下命令启动服务器:

    • 如果使用 'ts-node': 'ts-node index.ts'
    • 如果使用 'node': 先运行 'pnpm build', 然后运行 'node dist/index.js'
  2. 配置 MCP 客户端: 将上述生成的 JSON 配置信息添加到您的 MCP 客户端(例如 Claude、Windsurf 或 Cursor)的 MCP 服务器配置中。

  3. 在 MCP 客户端中使用: 配置完成后,您可以在 MCP 客户端中:

    • 通过 Prompt 或客户端界面调用预设的 Solana 工具 (例如 'getAccountInfo', 'getBalance', 'getTransaction') 来查询 Solana 网络数据。
    • 使用预设的 Prompt 模板 (例如 'calculate-storage-deposit', 'why-did-my-transaction-fail'),让 LLM 辅助您进行 Solana 开发任务。
    • 访问 Solana 文档资源,获取开发参考信息。

安全提示: 请注意,这是一个简单的演示示例,不应用于生产环境。 MCP 协议仍在发展中,请谨慎对待来自未知开发者的 MCP 服务器,并在沙箱环境中测试,避免泄露敏感信息。

信息

分类

开发者工具