JinDaGe - lifi-mcp MCP Details

article

README

🚀 LI.FI MCP 服务器

LI.FI MCP 服务器与 LI.FI API 集成，为用户提供跨链兑换功能，支持多个流动资金池和桥接服务，极大地提升了资产在不同链之间的流通性。

⚠️ 重要提示

请勿使用此工具处理您的主钱包 keystore 或包含重要资金的_wallets_！此工具仅用于测试和实验用途。由于软件错误或安全漏洞、交易错误或配置问题、网络问题或智能合约故障等原因，可能会导致资金损失。LI.FI 或此工具的开发人员不对因使用此开源软件而导致的资金损失负责。请仅使用测试钱包！

✨ 主要特性

与 LI.FI API 集成，提供跨链兑换功能。
支持多个流动资金池和桥接服务。
提供丰富的工具组件，涵盖代币信息、链信息、跨链操作、钱包操作和交易操作等。

📦 安装指南

全局安装（推荐）

您可以将 LI.FI MCP 服务器作为全局命令安装到您的系统中：

npm install -g li-fi-mcp-server

局部安装

您也可以在项目中进行局部安装：

npm install li-fi-mcp-server

💻 使用示例

基础用法

启动 MCP 服务器（位于当前目录的 node_modules/.bin 或全局安装的位置）：

li-fi-mcp-server

高级用法

要使用自定义配置文件，请提供 --config 参数：

li-fi-mcp-server --config ./path/to/config.json

📚 详细文档

组件

工具

代币信息

GetTokens
- 功能：获取 LI.FI 服务已知的所有代币。
- 参数: chains, chainTypes, minPriceUSD
GetToken
- 功能：获取特定代币的详细信息。
- 参数: chain（必需）, token（必需）

链信息

GetChains
- 功能：获取所有支持链的信息。
- 参数: chainTypes
GetChainById
- 功能：根据 ID 查找链。
- 参数: id（必需）
GetChainByName
- 功能：根据名称、关键或 ID（不区分大小写）查找链。
- 参数: name（必需）

跨鏈操作

GetQuote
- 功能：获取代币传输（跨链或同一链内）的报价。
- 参数: fromChain, toChain, fromToken, toToken, fromAddress, fromAmount 等。
GetStatus
- 功能：检查跨链传输的状态。
- 参数: txHash（必需）, bridge, fromChain, toChain
GetConnections
- 功能：返回所有可能的链间连接。
- 参数: fromChain, toChain, fromToken, toToken, chainTypes
GetTools
- 功能：获取可用桥接和交易所。
- 参数: chains

钱包操作

GetWalletAddress
- 功能：获取加载的私钥对应的 Ethereum 地址。
GetNativeTokenBalance
- 功能：获取钱包的原生代币余额。
- 参数: rpcUrl（必需）, address（必需）
GetTokenBalance
- 功能：获取特定 ERC20 代币在钱包中的余额。
- 参数: tokenContractAddress（必需）, accountAddress
GetNativeBalance
- 功能：获取 Ethereum 钱包地址的 ETH 余额。

交易操作

TransferEth
- 功能：发送 ETH。
- 参数: toAddress, amountInEth
TransferToken
- 功能：发送 ERC20 代币。
- 参数: toAddress, tokenContractAddress, amountInTokens

配置

以下是配置文件 config.json 的示例：

{
  "port": "8080",            // MCP 服务器监听的端口（默认：8080）
  "keystore": "./wallets/keys", // 存放 keystore 文件的目录路径（默认：./wallets/keys）
  "etherscanKey": "",          // 可选，Etherscan API 密钥
  "polygonScanKey": ""         // 可选，Polygon Scan API 密钥
}

📄 许可证

MIT

lifi-mcp