educhain-ai-agent-kit

🚀 帆鱼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文件。