Shardeum MCP Server

Overview

The Shardeum MCP (Model Context Protocol) Server is a powerful blockchain interaction tool that provides comprehensive access to the Shardeum network through standardized RPC methods. It enables AI agents, developers, and applications to seamlessly query and interact with the Shardeum blockchain.

Key Features

• Comprehensive RPC Method Support
  • Ethereum standard methods
  • Shardeum-specific network methods
• Flexible Blockchain Querying
• 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

Prerequisites

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

Connecting with Cursor

1. Clone the repo and do an npm install
2. Open Cursor
3. Go to Cursor Settings
4. Scroll to “MCP”
5. Click “Add new MCP server”
6. Enter details:

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

Example Queries

Checking Balance

Ask Cursor:

• “What is the balance of 0x1234… on Shardeum?”
• “Check ETH balance for this address”

Exploring Transactions

• “Show details for transaction 0x5678…”
• “Analyze the latest block on Shardeum”

Contributing

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

Configuration

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

Troubleshooting

• Ensure Node.js 18.x is installed
• Check network connectivity
• Verify RPC endpoint accessibility
• Update to the latest version

Roadmap

• [ ] Add more networks for accessibility
• [ ] Make it write friendly to execute transactions
• [ ] Enhance error handling
• [ ] Improve performance
• [ ] Expand tool capabilities

Supported Networks

• Shardeum Local
• More networks coming soon!