帆鱼DEX MCP服务器使用指南

项目简介

帆鱼DEX（SailFish DEX）是一个去中心化交易所，提供代币交易服务。此MCP服务器为帆鱼DEX提供了多种工具和资源接口。

核心功能

代币与池信息

• 获取代币价格及详情
• 查看流动性池信息
• 获取市场概览数据

交易辅助工具

• 拉取交易对信息
• 获取换汇报价
• 执行实际的代币兑换操作
• 支持滑点控制
• 提供 Arbitrage机会检测功能

使用指南

安装步骤

1. 确保已安装Node.js环境
2. 克隆此仓库到本地
3. 安装依赖包：

   npm install
   

4. 构建项目：

   npm run build
   

5. 将MCP服务器配置到Claude Desktop配置文件中：

{
  "mcpServers": {
    "sailfish": {
      "command": "node",
      "args": ["/path/to/SubgraphMCP/build/index.js"],
      "env": {
        "RPC_URL": "https://your-edu-rpc-url.com"
      }
    }
  }
}

使用示例

获取代币价格

use_mcp_tool("sailfish", "get_token_price", {
  "tokenId": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342"
});

获取换汇报价

use_mcp_tool("sailfish", "get_swap_quote", {
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10"
});

执行代币兑换

use_mcp_tool("sailfish", "swap_tokens", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "tokenIn": "0xd02E8c38a8E3db71f8b2ae30B8186d7874934e12",
  "tokenOut": "0x836d275563bAb5E93Fd6Ca62a95dB7065Da94342",
  "amountIn": "10",
  "slippagePercentage": 0.5
});

检查套利机会

use_mcp_tool("sailfish", "check_arbitrage_opportunities", {
  "threshold": 1.5
});

更新外部市场API配置

use_mcp_tool("sailfish", "update_external_market_config", {
  "apiUrl": "https://api.example.com/crypto/prices",
  "apiKey": "YOUR_API_KEY",
  "symbols": {
    "EDU": "EDU",
    "USD": "USDT"
  }
});

EDU与WEDU转换

use_mcp_tool("sailfish", "wrap_edu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

use_mcp_tool("sailfish", "unwrap_wedu", {
  "privateKey": "YOUR_PRIVATE_KEY",
  "amount": "10"
});

测试

运行测试脚本以验证功能：

node build/test.js

此脚本将测试路由和换汇报价功能，但不会执行实际交易。

许可证

该项目采用MIT许可证，具体内容请参阅LICENSE文件。