Polygon MCP Server

基本能力

产品定位

Polygon MCP Server 是一个区块链中间件，专注于为 AI 系统提供与 Polygon 网络的交互能力，简化复杂的区块链操作。

核心功能

1. 钱包操作：包括获取钱包地址、请求测试网 POL、列出代币余额、转账等功能。
2. 智能合约操作：支持部署和验证智能合约，提供多种合约模板（如 ERC20、ERC721、ERC1155 等）。
3. L2 桥接操作：支持 ETH 和 ERC20 代币在 Ethereum 和 Polygon 之间的存款和提款。
4. DeFi 交互：与 QuickSwap DEX 和 Uniswap V3 集成，支持代币交换、添加流动性等操作。
5. 交易模拟：提供交易模拟和 gas 估算功能，帮助用户预览交易效果。
6. 网络工具：获取当前 gas 价格、切换网络等实用功能。

适用场景

1. 区块链开发：快速部署和测试智能合约。
2. DeFi 应用：进行代币交换、流动性提供等操作。
3. 跨链操作：在 Ethereum 和 Polygon 之间转移资产。
4. 交易分析：模拟交易以预估成本和效果。

工具列表

1. 钱包工具：get-address, get-testnet-pol, list-balances, transfer-funds
2. 智能合约工具：deploy-contract, verify-contract, list-contract-templates
3. 桥接工具：deposit-eth, withdraw-eth, deposit-token, withdraw-token
4. DeFi 工具：swap-tokens, get-swap-quote, add-liquidity, uniswapV3SwapSingle, uniswapV3SwapMulti
5. 交易工具：simulate-transaction, estimate-gas
6. 网络工具：get-gas-price, switch-network

常见问题解答

1. 钱包未连接错误：确保 .env 文件中正确设置了 PRIVATE_KEY。
2. RPC 连接问题：检查 RPC 端点 URL 或尝试更换 RPC 提供商。
3. 资金不足：确保钱包中有足够的 POL 支付 gas 费。
4. 交易失败：使用交易模拟功能诊断问题。

使用教程

使用依赖

1. Node.js (v18 或更高版本)
2. npm 或 yarn
3. Polygon 钱包私钥
4. Polygon Mainnet 和 Amoy Testnet 的 RPC 端点

安装教程

1. 克隆仓库或下载源代码
2. 安装依赖：

cd polygonmcp
npm install

1. 创建 .env 文件并配置必要变量

运行服务器

npm start

或开发模式（自动重启）：

npm run dev

调试方式

1. 检查钱包余额：

const balances = await server.listBalances();
console.log('Wallet balances:', balances);

1. 获取测试网 POL（仅限 Amoy 测试网）：

const result = await server.getTestnetPol();
console.log('Faucet result:', result);

1. 模拟交易：

const result = await server.simulateTransaction({
  to: '0x1234...',
  value: '0.01'
});
console.log('Simulation result:', result);

许可证

该项目遵循 MIT 开源许可条款。