Solana交易服务器 (solana-MCP-tradingserver)
项目简介
solana-MCP-tradingserver 是一个基于 Model Context Protocol (MCP) 构建的应用后端,专注于 Solana 链上的代币交易。它允许用户通过 MCP 客户端调用工具,实现 Solana 钱包的创建和导入、代币余额查询、从 Jupiter DEX 聚合器获取交易报价以及执行代币兑换等操作。此服务器旨在为 LLM 应用提供 Solana 交易能力。
主要功能点
- 钱包管理: 支持创建新的 Solana 钱包和导入已有的钱包。
- 余额查询: 可以查询指定钱包地址和代币 Mint 地址的代币余额。
- 交易报价: 集成 Jupiter DEX 聚合器,提供代币兑换的报价,支持自定义滑点设置。
- 执行交易: 根据交易报价,执行代币兑换操作。
- 交易状态跟踪: 提供交易状态查询,确认交易是否成功。
安装步骤
- 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm 包管理器。
- 克隆仓库: 使用 git 命令克隆 'solana-MCP-tradingserver' 仓库到本地。
git clone https://github.com/8bitsats/solana-MCP-tradingserver.git cd solana-MCP-tradingserver - 安装依赖: 在仓库根目录下运行 npm 命令安装项目依赖。
npm install - 构建项目: 运行 npm 命令编译 TypeScript 代码。
npm run build - 运行服务器: 使用 Node.js 运行编译后的服务器代码。
或者使用 Docker 运行:node build/index.jsdocker-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" 部分,查看更详细的工具调用示例。
信息
分类
商业系统