1英寸跨链交换工具

使用 1inch Fusion+ 和模型上下文协议 (MCP) 执行跨链代币交换的工具。

演示视频

视频标题

Related MCP server: uniswap-trader-mcp

概述

该工具使用 1inch Fusion+ API 实现不同区块链（Arbitrum、Base、Polygon 等）之间的跨链代币兑换。它处理整个兑换流程，从发起订单到通过后台工作系统监控执行状态。

安装

必须使用pnpm或yarn而不是npm安装依赖项：

pnpm install
# or
yarn install

配置

该项目必须设置为 CommonJS 项目。如果将其导入为 ESM，则库的设计将无法以当前形式运行。

在根目录中创建一个.env文件并使用以下变量填充它：

DEV_PORTAL_KEY=replace_with_developer_portal_api_key
WALLET_ADDRESS=replace_with_wallet_address
WALLET_KEY=replace_with_wallet_private_key
RPC_URL_ETHEREUM=replace_with_ethereum_rpc_url
RPC_URL_BASE=replace_with_base_rpc_url
INCH_API_KEY=replace_with_1inch_api_key

用法

启动 MCP 服务器

npm start

这将启动模型上下文协议服务器，该服务器公开用于跨链交换和投资组合管理的工具。

可用的 MCP 工具

该工具提供以下 MCP 功能，可与 Claude 或其他兼容 MCP 的助手一起使用：

跨链交换

swap ：发起跨链代币交换

Parameters:
- srcChainId: Source chain ID (default: 8453/Base)
- dstChainId: Destination chain ID (default: 42161/Arbitrum)
- srcTokenAddress: Source token address
- dstTokenAddress: Destination token address
- amount: Amount to swap (in base units or human-readable format)
- invert: Swap direction toggle (default: false)

订单管理

swap-status ：检查掉期订单的状态

Parameters:
- orderHash: (Optional) Specific order hash to check

投资组合管理

portfolio-protocols-value ：获取投资组合中协议的价值
```
Parameters:
- chainId: Blockchain ID (default: 1/Ethereum)
```

portfolio-tokens-details ：获取有关你的投资组合中代币的详细信息

Parameters:
- chainId: Blockchain ID (default: 1/Ethereum)
- closed: Include closed positions (default: true)
- closedThreshold: Threshold for considering positions closed (default: 1)

portfolio-general-value ：获取投资组合的总体价值
```
Parameters:
- chainId: Blockchain ID (default: 1/Ethereum)
```
portfolio-value-chart ：获取投资组合价值随时间变化的图表数据
```
Parameters:
- chainId: Blockchain ID (default: 1/Ethereum)
```

监控系统

该应用程序包括一个监控和处理掉期订单的后台工作系统：

监控命令

# Start the monitor daemon
npm run monitor:start

# Check status of all orders
npm run status

# Check status of monitor daemon
npm run monitor:status

# Stop the monitor daemon
npm run monitor:stop

工人系统如何运作

当发起掉期交易时，订单信息保存到order-status.json
监控守护进程不断检查需要监控的新订单
对于每个新订单，都会生成一个专用的工作进程
工作人员监控订单状态并在需要时提交机密以完成交换
一旦订单被执行，工人就会被解雇，状态也会更新

技术说明

采用 1inch Cross-Chain SDK 构建，实现安全的跨链交换
使用模型上下文协议进行人工智能助手集成
Fusion SDK 中的PrivateKeyProviderConnector支持 BlockchainProviderConnector
该工具负责跨链交换验证的秘密管理

1inch Cross-Chain Swap MCP Server