MCP Monad

🚀 MCP Monad

MCP (Model Context Protocol) is a protocol designed to connect AI models with external data sources. This project offers an MCP server implemented based on the Monad framework, supporting multiple functional modules.

🚀 Quick Start

Prerequisites

• Operating System: Any system that supports Node.js (Windows, Linux, macOS).
• Node.js: Version 14 or higher.
• npm/yarn: Version 6 or higher.

Installation

git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad
npm install

Configure Environment Variables

Copy the example environment file and edit it:

cp .env.example .env

Open the .env file in a text editor and fill in the following content:

PRIVATE_KEY=0xyourprivatekeyhere
UNISWAP_ROUTER_ADDRESS=0xfb8e1c3b833f9e67a71c859a132cf783b645e436
UNISWAP_FACTORY_ADDRESS=0x733e88f248b742db6c14c0b1713af5ad7fdd59d0
WMON_ADDRESS=0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701

Replace 0xyourprivatekeyhere with your Monand testnet wallet private key (a 64 - character hexadecimal string starting with 0x).

Ensure that the .env file is not under version control and add it to .gitignore:

echo .env >> .gitignore

Build and Run

Build the project:

npm run build

Start the MCP server:

node build/index.js

✨ Features

Coinflip Game

A coin - flipping game running through the contract address 0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b.

Staking Mechanism

Supports users to stake tokens for rewards. Related operations include:

• stake - aprmon: Stake tokens.
• unstake - aprmon: Unstake tokens.
• claim - aprmon: Claim rewards.

Swap Trading

Integrates the Uniswap protocol, allowing users to exchange tokens on the Monand network.

📦 Project Structure

mcp-monad/
├── src/
│   ├── server.ts
│   └── modules/
│       ├── coinflip/
│       │   └── game.ts
│       ├── stake/
│       │   └── aprmon.ts
│       └── swap/
│           └── uniswap.ts
├── build/
│   └── index.js
└── .env.example

📚 Integration with Claude Desktop

1. Open the Claude desktop application.
2. Navigate to the Settings > Developers menu.
3. Edit the claude_desktop_config.json file (usually located at ~/.config/Claude/ or %APPDATA%\Claude\), and add the following configuration:

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-monad/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Replace /path/to/mcp-monad/ with the actual project path (e.g., E:\proyek\mcp-monad on Windows or /home/user/mcp-monad on Linux).

4. Restart Claude Desktop.
5. When prompted, allow the MCP service to use permissions in the current chat session (select Allow for This Chat).

🤝 Contribution Guidelines

1. Create a Branch: Create a feature branch for new features (e.g., git checkout -b feature/AmazingFeature).
2. Commit Changes: Record your modifications (e.g., git commit -m 'Add some AmazingFeature').
3. Push Changes: Push the branch to the remote repository (e.g., git push origin feature/AmazingFeature).
4. Create a Pull Request: Initiate a merge request on GitHub.

📄 License

This project is licensed under the MIT License.

📞 Contact Information

• Author: Semutireng
• Email: semu@monand.org
• GitHub: Semutireng/mcp-monad

⚠️ Important Note

• Dependency Management: Ensure that all dependencies are correctly installed. Use npm install or yarn install for installation.
• Wallet Configuration: Keep your private key secure and avoid disclosure. It is recommended to use testnet tokens in the test environment.
• Contract Address Verification: Confirm that all contract addresses are correct. Multiple rounds of testing are recommended before formal use.
• Security Precautions: Maintain the security of the codebase and conduct regular security audits. Check for known vulnerabilities when updating dependencies.

By following the above steps, you will be able to successfully run and integrate the MCP monad server into the Monand network.