Metamask Blockchain Toolkit

🚀 MCPilot Project

MCPilot provides a series of MCP servers, enabling Large Language Models (LLMs) to interact with the blockchain through MetaMask wallets, ensuring users don't need to expose their private keys or risk asset loss. It serves as an important toolset connecting AI and blockchain technology, while simplifying the user's on - chain boarding process.

⚠️ Important Note

This project is a proof - of - concept developed during the ETHGlobal Hackathon Taipie 2025 and is not suitable for production environments. Please visit [metamask - mcp](https://github.com/Xiawpohr/metamask - mcp) for a production - ready application.

🚀 Quick Start

LLMs have revolutionized the way we use digital tools. Communicating with AI in natural language to complete tasks eliminates the need to read manuals or learn complex systems, greatly simplifying the user's operation process, especially in the Web3 field. Based on this vision, many Web3 and DeFi agents have been developed.

However, the MCPilot project focuses on ensuring the security of user private keys through integration with MetaMask, without exposing them in AI agents. This design not only enhances security but also provides a reliable and easy - to - use interaction interface for developers and users.

✨ Features

• Natural language blockchain interaction: Users can complete complex blockchain operations through simple Chinese instructions.
• Secure private key storage: Private keys are always kept within the MetaMask wallet, and MCPilot will not access or disclose this information.
• Interoperability between Web2 and Web3 services: Enables seamless connection and data interaction between different ecosystems.

🔧 Technical Details

Core Technologies

• Large Language Models (LLMs): Used to understand and generate natural language instructions and convert them into blockchain operations.
• MetaMask integration: Performs authentication and transaction signing through the API provided by MetaMask.
• MCP Protocol: Defines the standard protocol for communication between servers to ensure the secure transmission and processing of data.

MCP Servers

The following are the MCP servers used in MCPilot and their functions:

1. MetaMask Processing Server (metamask - mcp)

   • Responsible for interacting with the MetaMask wallet, including authentication, transaction signing, etc.

2. Blockchain Network Information Server (network - info - mcp)

   • Provides information query services for different blockchain networks, such as Polygon, Celo, and Zircuit.

3. Solidity Compiler Server (solidity - compiler - mcp)

   • Used to compile Solidity smart contracts and return the compilation results.

4. Token Standard Processing Server (token - standard - mcp)

   • Supports interaction operations for token standards such as ERC20 and ERC721.

5. Blockchain Explorer Integration Server (block - explorer - integrator - mcp)

   • Integrates various blockchain explorers (such as PolygonScan, CeloScan) to provide address and transaction details query functions.

💻 Usage Examples

Basic Usage

When configuring Claude Desktop, you need to add the following content to the configuration file:

{
  "mcpServers": {
    "metamask-mcp": {
      "command": "npx meta-mcp",
      "args": ["--port", "3001"],
      "env": {
        "METAMASK_API_KEY": ""
      }
    },
    "network-info-mcp": {
      "command": "npx network-info-mcp",
      "args": ["--polygon", "--celo", "--zircuit"],
      "env": {}
    },
    "solidity-compiler-mcp": {
      "command": "npx solidity-compiler-mcp",
      "args": [],
      "env": {}
    },
    "token-standard-mcp": {
      "command": "npx token-standard-mcp",