使用说明

项目简介

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 代币合约信息和余额查询。

安装步骤

  1. 安装 Node.js: 确保你的系统已安装 Node.js 环境 (建议 v16 或更高版本)。
  2. 下载仓库代码: 从 GitHub 仓库 https://github.com/Dbillionaer/polygon-mcp 克隆或下载代码。
  3. 安装依赖: 在项目根目录下打开终端,运行 '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 规范暴露资源和工具。

基本使用方法

(由于缺少可运行的服务器,以下为基于代码功能的假设使用方法)

  1. 启动 MCP 服务器 (你需要先自行构建可运行的服务器入口).
  2. 配置 MCP 客户端: 在你的 LLM 应用或 MCP 客户端中,配置上述 '服务器配置' 信息,连接到你启动的 Polygon DeFi MCP Server。
  3. 使用 MCP 客户端调用工具: 通过 MCP 客户端,你可以调用服务器提供的各种工具,例如:
    • 使用 'defi.quickSwapTokens' 工具进行 QuickSwap 代币兑换。
    • 使用 'bridge.depositETH' 工具进行 ETH 跨链存款。
    • 使用 'contractTemplates.deployFromTemplate' 工具部署智能合约。
    • 使用 'simulator.simulateTransaction' 工具模拟交易。
    • 使用 'token.getTokenBalance' 工具查询代币余额。

重要提示: 此仓库的代码更像是一个工具库,而非一个开箱即用的 MCP 服务器。你需要具备一定的开发能力,才能基于这些代码构建一个符合 MCP 规范的服务器应用。

信息

分类

网页与API