Solana交易服务器 (solana-MCP-tradingserver)

项目简介

solana-MCP-tradingserver 是一个基于 Model Context Protocol (MCP) 构建的应用后端,专注于 Solana 链上的代币交易。它允许用户通过 MCP 客户端调用工具,实现 Solana 钱包的创建和导入、代币余额查询、从 Jupiter DEX 聚合器获取交易报价以及执行代币兑换等操作。此服务器旨在为 LLM 应用提供 Solana 交易能力。

主要功能点

  • 钱包管理: 支持创建新的 Solana 钱包和导入已有的钱包。
  • 余额查询: 可以查询指定钱包地址和代币 Mint 地址的代币余额。
  • 交易报价: 集成 Jupiter DEX 聚合器,提供代币兑换的报价,支持自定义滑点设置。
  • 执行交易: 根据交易报价,执行代币兑换操作。
  • 交易状态跟踪: 提供交易状态查询,确认交易是否成功。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm 包管理器。
  2. 克隆仓库: 使用 git 命令克隆 'solana-MCP-tradingserver' 仓库到本地。
    git clone https://github.com/8bitsats/solana-MCP-tradingserver.git
    cd solana-MCP-tradingserver
  3. 安装依赖: 在仓库根目录下运行 npm 命令安装项目依赖。
    npm install
  4. 构建项目: 运行 npm 命令编译 TypeScript 代码。
    npm run build
  5. 运行服务器: 使用 Node.js 运行编译后的服务器代码。
    node build/index.js
    或者使用 Docker 运行:
    docker-compose up -d

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 solana-MCP-tradingserver 服务器。

{
  "server_name": "solana-trading-server",  // 服务名称,代码中已定义
  "command": "node",                      // 运行服务器的命令
  "args": ["build/index.js"]             // 运行服务器命令的参数,指向编译后的 index.js 文件
}

基本使用方法

solana-MCP-tradingserver 通过 MCP 协议与客户端通信,并提供以下工具 (Tools) 供客户端调用:

  • create_wallet: 创建新的 Solana 钱包。无需参数。
  • import_wallet: 导入已有的 Solana 钱包。参数:
    {
      "privateKey": "你的钱包私钥 (Base58 编码)"
    }
  • get_token_balance: 查询代币余额。参数:
    {
      "walletAddress": "钱包地址 (Solana 公钥)",
      "tokenMint": "代币 Mint 地址"
    }
  • get_swap_quote: 获取代币兑换报价。参数:
    {
      "inputMint": "输入代币 Mint 地址",
      "outputMint": "输出代币 Mint 地址",
      "amount": "输入代币数量 (最小单位)",
      "slippage": "滑点容忍度 (0-100 的数字,例如 1 代表 1%)"
    }
  • execute_swap: 执行代币兑换。参数:
    {
      "quote": "get_swap_quote 工具返回的报价对象",
      "walletPrivateKey": "钱包私钥 (Base58 编码)"
    }

你可以使用 MCP 客户端,如 'use_mcp_tool' 函数 (示例见 'README.md'),来调用这些工具并与 solana-MCP-tradingserver 交互,实现 Solana 代币交易功能。请参考仓库 'README.md' 文件中的 "Testing the Functionality" 部分,查看更详细的工具调用示例。

信息

分类

商业系统