Monad Bridge MCP Server

🚀 Monad Bridge MCP Server

A lightweight Model Context Protocol (MCP) server that connects the bridging functionality between the Ethereum Sepolia and Monad testnets via the Wormhole bridge. This MCP interacts with the Monadbridge and Wormholes APIs.

✨ Features

This MCP server provides the following tools:

🚀 Quick Start

Clone the repository

git clone https://github.com/rawakinode/monad-bridge-mcp-server.git
cd monad-bridge-mcp-server
npm install

Build and run

npm run build

📦 Installation

Prerequisites

• Node.js (v16 or higher)
• npm or yarn
• Claude Desktop (for MCP client integration)

How to use

1. Download and install Claude Desktop.
2. Open Claude Desktop.
3. Go to Settings > Developers.
4. Open the configuration file. Edit claude_desktop_config.json.
5. Add the following configuration:

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": ["<your-local-path>monad-bridge-mcp-server\\build\\index.js"],
      "env": {
        "PRIVATE_KEY": "<your-private-key>" 
      }
    }
  }
}

6. Replace <your-local-path>monad-bridge-mcp-server\\build\\index.js with the actual project directory path (e.g., E:\\data\\monad-bridge-mcp-server\\build\\index.js or /path/to/monad-bridge-mcp-server/build/index.js).
7. Complete the configuration as prompted.

💻 Usage Examples

Basic Usage

Here is a complete example:

1. Clone the repository and install dependencies:

git clone https://github.com/rawakinode/monad-bridge-mcp-server.git
cd monad-bridge-mcp-server
npm install

2. Build the project:

npm run build

3. Configure Claude Desktop:

   • Open claude_desktop_config.json.
   • Add the following content:

     {
       "mcpServers": {
         "monad-mcp": {
           "command": "node",
           "args": ["E:\\data\\monad-bridge-mcp-server\\build\\index.js"],
           "env": {
             "PRIVATE_KEY": "your_private_key_here"
           }
         }
       }
     }
     

   • Save the file.

4. Use the command-line tools:

   get-wallet-address
   # Output: 0xYourWalletAddress
   
   bridge-sepolia-wmon-to-monad 1
   # Bridge 1 wmon from Sepolia to Monad
   
   get-10-last-bridge-transaction
   # Get the last 10 bridge transaction records
   

⚠️ Important Note

• Ensure the security of your private key and avoid disclosure.
• Always back up your configuration files before using them in a production environment.
• If you encounter any issues, check the logs or contact the support team.

📷 Screenshots

Figure 1: Configuration Interface

Figure 2: Command Line Tool Example

Figure 3: Bridging Process