关键词

区块链Web3自然语言交互加密货币钱包智能合约

项目简介

Web3 MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用，旨在帮助大语言模型 (LLM) 客户端以自然语言的方式与区块链和 Web3 应用进行交互。它通过一个配套的 Web 应用程序安全地处理用户的加密货币钱包操作（如签名、发送交易），从而避免 LLM 客户端直接处理私钥等敏感信息。服务器负责根据 LLM 的请求，通过 WebSocket 与 Web 应用通信，指示其执行相应的区块链操作，并将结果返回给 LLM 客户端。

主要功能点

  • 自然语言交互: 允许用户通过支持 MCP 的 LLM 客户端使用自然语言指令来执行区块链操作。
  • 钱包管理中介: 服务器本身不管理私钥，而是通过配套的 Web 应用连接用户的浏览器钱包（如 MetaMask），所有签名请求都在 Web 应用中完成，确保安全性。
  • 状态查询: 允许 LLM 查询连接钱包的当前状态，包括活动账户、当前网络、原生货币余额等。
  • 网络切换: 允许 LLM 指示 Web 应用切换到指定的区块链网络。
  • 发送交易: 支持通过自然语言指令向指定地址发送原生货币。
  • 资源发现: 提供区块链网络（Chains）和智能合约（Contracts）的信息作为 MCP 资源，供 LLM 理解和引用。

安装步骤

  1. 从项目的 Releases 页面 下载适用于您操作系统的最新服务器二进制文件。
  2. 将下载的二进制文件保存到您的计算机上。
  3. 运行该二进制文件。服务器将在后台启动，并通过标准输入/输出 (Stdio) 协议与 MCP 客户端通信，同时启动一个 WebSocket 服务器（默认端口 65001）与配套的 Web 应用通信。

服务器配置（为MCP客户端准备）

MCP 服务器启动后，MCP 客户端需要知道如何启动并连接到它。以下是 MCP 客户端（例如 Claude Desktop）中可能需要的配置信息格式示例。请将此信息添加到您的 MCP 客户端配置文件的相应位置：

{
  "mcpServers": {
    "web3-mcp": {
      "command": "/path/to/your/web3-mcp-binary", // 替换为您实际下载的服务器二进制文件路径
      "args": [] // 此服务器目前不需要额外的启动参数
    }
  }
}
  • '"web3-mcp"': 这是您给这个 MCP 服务器实例定义的名称，可以在客户端中自定义。
  • '"command"': 指定服务器二进制文件的完整路径。请根据您的操作系统和文件位置进行修改。
  • '"args"': 此服务器目前不需要额外的启动参数，留空即可。

基本使用方法

  1. 启动 Web 应用: 在您的浏览器中访问配套的 Web 应用页面（例如：web3-mcp.vercel.app）。
  2. 连接钱包: 在 Web 应用中，确保您的浏览器钱包（如 MetaMask）已解锁并连接到该页面。LLM 在首次尝试区块链操作时通常会提示您连接钱包。
  3. 启动 MCP 服务器: 运行您下载的 Web3 MCP 服务器二进制文件。
  4. 配置并启动 MCP 客户端: 根据上述“服务器配置”说明配置您的 MCP 客户端，并确保客户端已启动并连接到 Web3 MCP 服务器。
  5. 使用自然语言指令: 在您的 MCP 客户端对话框中，使用自然语言向 LLM 发出指令，例如：
    • "Connect my wallet." (连接我的钱包)
    • "What is my current status?" (我的当前状态是什么？ - 获取账户、网络、余额信息)
    • "Change network to Polygon." (切换网络到 Polygon)
    • "Send 0.1 ETH to 0x..." (发送 0.1 ETH 到地址 0x...)
    • "Show me the details of the USDC contract." (显示 USDC 合约的详细信息)
  6. 批准交易: 当 LLM 发起需要签名批准的操作（如发送交易）时，您的浏览器钱包会弹出提示，您需要在钱包界面中完成签名和批准。
  7. 查看结果: 操作结果（如交易哈希、查询到的余额等）将通过服务器返回并在 MCP 客户端中显示。

信息

分类

AI与计算

访问项目