使用说明
项目简介
Polygon DeFi MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为大型语言模型(LLM)应用提供访问去中心化金融(DeFi)和区块链网络的能力。该服务器专注于 Polygon (Matic) 网络,集成了与 QuickSwap、Uniswap V3、Polymarket 等 DeFi 协议的交互功能,并支持 Polygon 与以太坊之间的跨链桥接操作。通过标准化的 MCP 协议,LLM 客户端可以安全、便捷地调用服务器提供的工具,获取链上数据,执行交易,从而构建更加智能和实用的区块链应用。
主要功能点
- DeFi 协议交互工具:
- 支持 QuickSwap 和 Uniswap V3 交易平台的代币兑换(Swap)、流动性添加等操作。
- 提供实时代币报价查询功能。
- 集成 Polymarket 预测市场,支持市场信息查询、仓位价格获取、下注和卖出仓位等功能。
- 支持 Uniswap V2 协议交互。
- Polygon 跨链桥接工具:
- 支持 ETH 和 ERC20 代币在以太坊和 Polygon 链之间的存款和提款操作。
- 提供桥接交易状态跟踪功能。
- 智能合约模板与部署:
- 内置常用智能合约模板(ERC20、NFT、Staking、Multisig),简化合约创建流程。
- 支持合约部署和区块浏览器验证。
- 交易模拟与分析:
- 提供交易模拟功能,在链下预演交易执行结果,评估 Gas 消耗等。
- 支持链上交易分析,解析交易详情和状态。
- 基础链上数据查询:
- 支持 ERC20、ERC721、ERC1155 代币合约信息和余额查询。
安装步骤
- 安装 Node.js: 确保你的系统已安装 Node.js 环境 (建议 v16 或更高版本)。
- 下载仓库代码: 从 GitHub 仓库 https://github.com/Dbillionaer/polygon-mcp 克隆或下载代码。
- 安装依赖: 在项目根目录下打开终端,运行 'npm install' 或 'yarn install' 安装项目依赖。
cd polygon-mcp npm install
服务器配置
MCP 客户端需要配置以下 JSON 格式信息以连接到 Polygon DeFi MCP Server。请注意,此仓库没有提供开箱即用的 MCP 服务器启动脚本,代码片段主要是一些功能模块。要使其成为一个可运行的 MCP 服务器,需要基于这些模块自行构建一个服务器入口,例如使用 Node.js 搭建一个 HTTP 或 WebSocket 服务器,并实现 MCP 协议的请求处理逻辑。
以下是一个假设的配置示例,你需要根据你构建的服务器入口进行调整。
{ "serverName": "polygon-defi-mcp-server", "command": "node", "args": [ "path/to/your/server-entrypoint.js" // 假设你的服务器入口文件是 server-entrypoint.js,你需要指定其路径 // 可以添加其他启动参数,例如配置文件路径等 ], "transport": "stdio", // 或 "webSocket", "sse" 等,取决于你的服务器实现 "protocol": "json-rpc" }
请注意: 由于此仓库缺少完整的服务器入口和 MCP 协议处理代码,它目前不能直接作为有效的 MCP 服务器运行。 你需要基于仓库提供的模块(例如 'polygon MCP.js' 中的 'PolygonMCPServer' 类 和其他工具模块),自行开发服务器端代码,实现 MCP 协议的请求接收、处理和响应逻辑,并根据 MCP 规范暴露资源和工具。
基本使用方法
(由于缺少可运行的服务器,以下为基于代码功能的假设使用方法)
- 启动 MCP 服务器 (你需要先自行构建可运行的服务器入口).
- 配置 MCP 客户端: 在你的 LLM 应用或 MCP 客户端中,配置上述 '服务器配置' 信息,连接到你启动的 Polygon DeFi MCP Server。
- 使用 MCP 客户端调用工具: 通过 MCP 客户端,你可以调用服务器提供的各种工具,例如:
- 使用 'defi.quickSwapTokens' 工具进行 QuickSwap 代币兑换。
- 使用 'bridge.depositETH' 工具进行 ETH 跨链存款。
- 使用 'contractTemplates.deployFromTemplate' 工具部署智能合约。
- 使用 'simulator.simulateTransaction' 工具模拟交易。
- 使用 'token.getTokenBalance' 工具查询代币余额。
重要提示: 此仓库的代码更像是一个工具库,而非一个开箱即用的 MCP 服务器。你需要具备一定的开发能力,才能基于这些代码构建一个符合 MCP 规范的服务器应用。
信息
分类
网页与API