EDUCHAIN Agent Kit

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

功能

代币和池信息

• 获取代币价格和详情
• 获取池信息和统计数据
• 查看代币和池的历史数据
• 获取按 TVL 排名的热门代币和池

钱包操作

• 查询 EDU 和代币余额
• 获取包含代币和 NFT 的钱包概览
• 发送 EDU 和 ERC20 代币

兑换操作

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

**注意：**与其他 Uniswap v3 分叉一样，SailFish DEX 不支持直接兑换原生代币。它会在内部使用 WEDU（Wrapped 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：获取钱包地址的代币余额及其 USD 价值
• 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（Wrapped EDU）
• unwrap_wedu：将 WEDU（Wrapped 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 上特定流动性池的信息

安装

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

将 WEDU 解包为 EDU

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

测试

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

node build/test.js

此操作将测试路由和兑换报价功能，但不会执行实际兑换。

许可证

本项目采用 MIT License 授权，详情请参阅 LICENSE 文件。