使用说明

项目简介

Token Revoke MCP 是一款基于 Model Context Protocol (MCP) 构建的服务器应用,旨在帮助用户安全管理其在多条 EVM 兼容链上的 ERC-20 Token 授权。通过简单的自然语言指令,用户可以查询钱包地址的 Token 授权情况,并执行授权撤销操作,从而降低 Web3 资产风险。

主要功能点

  • 多链 Token 授权查询: 支持 50+ EVM 兼容链,快速检索指定钱包在不同链上的 ERC-20 Token 授权信息,包括 Token 详情、余额、美元价值、授权额度等。
  • Token 授权撤销: 用户可以指定 Token 合约地址和授权地址,服务器将自动提交交易以撤销相应的 Token 授权,保护资产安全。
  • 交易状态查询: 支持根据交易哈希查询授权撤销交易的状态,确保操作成功执行。
  • 易于集成: 作为 MCP 服务器,可以与任何兼容 MCP 协议的客户端 (如 LLM 应用) 无缝集成,通过标准化的 JSON-RPC 协议进行通信。

安装步骤

  1. 克隆仓库到本地:
    git clone https://github.com/kukapay/token-revoke-mcp.git
    cd token-revoke-mcp
  2. 安装依赖:
    npm install

服务器配置

要使 MCP 客户端能够连接并使用 Token Revoke MCP 服务器,需要在客户端的 MCP 服务器配置中添加以下信息。请注意,以下配置为 JSON 格式,您需要将其添加到 MCP 客户端的配置文件中。

{
  "mcpServers": {
    "token-revoke-mcp": { <!-- 服务名称,客户端通过此名称引用 -->
      "command": "node",  <!-- 启动服务器的命令 -->
      "args": ["path/to/token-revoke-mcp/index.js"], <!-- 启动命令的参数,指向服务器入口文件 index.js 的路径 -->
      "env": { <!-- 环境变量配置 -->
        "MORALIS_API_KEY": "YOUR_MORALIS_API_KEY",  <!-- Moralis API Key,用于获取 Token 授权数据,请替换为您的 Moralis API Key -->
        "PRIVATE_KEY": "YOUR_WALLET_PRIVATE_KEY"   <!-- 钱包私钥,用于签名授权撤销交易,请替换为您的钱包私钥,请务必谨慎保管私钥 -->
      }
    }
  }
}

请根据实际情况修改 'path/to/token-revoke-mcp/index.js' 和 'YOUR_MORALIS_API_KEY','YOUR_WALLET_PRIVATE_KEY' 为您自己的配置。

基本使用方法

  1. 启动服务器: 在 'token-revoke-mcp' 仓库目录下,执行以下命令启动 MCP 服务器:

    node index.js

    服务器默认使用 Stdio 传输协议,启动后会监听来自 MCP 客户端的请求。

  2. 通过 MCP 客户端与服务器交互: 使用兼容 MCP 协议的客户端(例如,基于 LLM 的应用),根据客户端的使用方式,通过自然语言指令或工具调用等方式与 Token Revoke MCP 服务器进行交互。

    示例指令 (以下指令为自然语言示例,实际使用方式取决于 MCP 客户端)

    • 查询 Polygon 链上的 Token 授权: "Show me all the token approvals for my wallet on Polygon."
    • 撤销 BSC 链上特定 Token 的授权: "Revoke the allowance for token 0x2791bca1f2de4661ed88a30c99a7a9449aa84174 to spender 0x1111111254eeb25477b68fb85ed929f73a960582 on BSC."
    • 查询交易状态: "Did my transaction 0x123... on BSC go through?"

    MCP 客户端会将这些指令转换为对 Token Revoke MCP 服务器的工具调用,服务器执行相应的操作并返回结果。具体指令和交互方式请参考 MCP 客户端的使用文档。

注意:

  • 请务必妥善保管您的 'MORALIS_API_KEY' 和 'PRIVATE_KEY',避免泄露。
  • 私钥用于签名交易,请在充分了解风险的情况下使用。
  • 本服务器目前仅支持 Stdio 传输协议。

信息

分类

商业系统