Shardeum MCP Server

🚀 Shardeum MCP Server

The Shardeum MCP Server is a powerful blockchain interaction tool that provides comprehensive access to the Shardeum network through standardized RPC methods, enabling seamless interaction for AI agents, developers, and applications.

🚀 Quick Start

The Shardeum MCP (Model Context Protocol) Server offers a standardized way to interact with the Shardeum blockchain. To get started, follow the installation steps and usage examples below.

✨ Features

• Comprehensive RPC Method Support
  • Ethereum standard methods
  • Shardeum-specific network methods
• Flexible Blockchain Queries
• Easy Integration with AI Assistants
• Blockchain Connectivity
• Detailed Error Handling

🛠️ Supported Methods

Ethereum Standard RPC Methods

• Block Information

  • eth_blockNumber
  • eth_getBlockByHash
  • eth_getBlockByNumber
  • eth_getBlockReceipts

• Transaction Methods

  • eth_getTransactionCount
  • eth_getTransactionByHash
  • eth_getTransactionByBlockHashAndIndex
  • eth_getTransactionByBlockNumberAndIndex
  • eth_getTransactionReceipt

• Account Methods

  • eth_getBalance
  • eth_estimateGas
  • eth_chainId

Shardeum Specific Methods

• shardeum_getNodeList
• shardeum_getNetworkAccount
• shardeum_getCycleInfo

📦 Installation

Prerequisites

• Node.js 18.x or higher
• Basic understanding of blockchain technology

Connecting with Cursor

1. Clone the repository and run npm install.
2. Open Cursor.
3. Go to Cursor settings.
4. Scroll to "MCP".
5. Click "Add new MCP Server".
6. Enter the following details:

{
  "mcpServers": {
    "shm-mcp": {
      "command": "node",
      "args": [
        "path_to\\shardeum-mcp-server\\index.js"
      ]
    }
  }
}

💻 Usage Examples

Basic Usage

Checking Balances

Ask Cursor:

• "What is the balance of address 0x1234... on Shardeum?"
• "Check the ETH balance of this address."

Exploring Transactions

• "Show the details of transaction 0x5678..."
• "Analyze the latest block on Shardeum."

🤝 Contribution

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Create a pull request.

📚 Documentation

Configuration

To use a different RPC endpoint, set the constant rpcUrl to another value.

Troubleshooting

• If an error occurs, check your network connection or try restarting the service.
• Refer to the project documentation for more support information.

🌟 Roadmap

• Future Plans
  • Expand support for more blockchain networks.
  • Improve performance and stability.
  • Add more RPC methods.

Supported Networks

• Currently supported: Mainnet, Testnet
• Future expansion: More public and private networks

📄 License