教育链AI代理工具包

Name: 教育链AI代理工具包
Author: SailFish-Finance

作者：SailFish-Finance5 星标更新：2025-07-08

项目介绍

EDUCHAIN 代理工具包

</div>

SailfishAgent

此 MCP（模型上下文协议）服务器提供了与 EDUCHAIN 交互的工具和资源。它允许 Claude 查询有关代币和池的信息，并通过 SailFish DEX 进行交换。

功能

代币和池信息

获取代币价格和详细信息
获取池信息和统计数据
查看代币和池的历史数据
获取按 TVL 排名的顶级代币和池

钱包操作

检查 EDU 和代币余额
获取钱包概览，包括代币和 NFT
发送 EDU 和 ERC20 代币

交换操作

获取交换报价，包括价格影响和路径信息
代币换代币
EDU 换代币（内部使用 WEDU）
代币换 EDU（内部使用 WEDU）

注意： SailFish DEX，像其他 Uniswap v3 分支一样，不直接支持原生代币交换。相反，它内部使用 WEDU（包装的 EDU）。当你使用 EDU 的交换功能时，系统会自动处理包装和解包过程，因此你可以直接在交易中使用 EDU。如果你需要更多的控制，也可以使用 wrap_edu 和 unwrap_wedu 函数手动转换 EDU 和 WEDU。

套利操作

从中心化交易所获取 EDU 的外部市场数据
检查 CEX 和 SailFish DEX 之间的套利机会
可配置的外部市场数据 API
自定义套利检测阈值

工具

代币和池信息

get_token_price: 获取 SailFish DEX 上代币的当前价格
get_token_info: 获取 SailFish DEX 上代币的详细信息
get_pool_info: 获取 SailFish DEX 上流动性池的详细信息
get_top_tokens: 获取 SailFish DEX 上按 TVL 排名的顶级代币列表
get_top_pools: 获取 SailFish DEX 上按 TVL 排名的顶级流动性池列表
get_total_tvl: 获取 SailFish DEX 上锁定总价值（TVL）
get_24h_volume: 获取 SailFish DEX 上 24 小时交易量
get_token_historical_data: 获取 SailFish DEX 上代币的历史数据
get_pool_historical_data: 获取 SailFish DEX 上流动性池的历史数据

钱包操作

get_edu_balance: 获取钱包地址的 EDU 余额
get_token_balance: 获取钱包地址的代币余额及美元价值
get_multiple_token_balances: 获取钱包地址的多个代币余额
get_nft_balance: 获取特定 NFT 收藏的钱包地址的 NFT 余额
get_wallet_overview: 获取钱包概览，包括 EDU、代币和 NFT
get_wallet_address_from_private_key: 从私钥获取钱包地址
send_edu: 向另一个钱包地址发送 EDU 原生代币
send_erc20_token: 向另一个钱包地址发送 ERC20 代币

交换操作

get_swap_quote: 获取在 SailFish DEX 上交换代币的报价
swap_tokens: 在 SailFish DEX 上交换代币（代币到代币）
swap_edu_for_tokens: 在 SailFish DEX 上用 EDU 换代币
swap_tokens_for_edu: 在 SailFish DEX 上用代币换 EDU
wrap_edu: 将 EDU 包装成 WEDU（包装的 EDU）
unwrap_wedu: 将 WEDU（包装的 EDU）解包成 EDU

套利操作

get_external_market_data: 从中心化交易所获取 EDU 的外部市场数据
check_arbitrage_opportunities: 检查 CEX 和 SailFish DEX 之间的套利机会
update_external_market_config: 更新外部市场数据 API 的配置
get_external_market_config: 获取当前的外部市场数据 API 配置

配置

set_rpc_url: 设置区块链交互的 RPC URL
get_rpc_url: 获取当前用于区块链交互的 RPC URL

资源

sailfish://overview: SailFish DEX 概览，包括 TVL、成交量等指标
sailfish://token/{tokenId}: SailFish DEX 上特定代币的信息
sailfish://pool/{poolId}: SailFish DEX 上特定流动性池的信息

安装

确保已安装 Node.js
克隆此仓库
安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

将 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"
});

将 WEDU 解包成 EDU

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

测试

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

node build/test.js

这将测试路由和交换报价功能，而不执行实际的交换。

许可证

本项目根据 MIT 许可证发布 - 详情见 LICENSE 文件。