shardeum-mcp-server
3.1
If you are the rightful owner of shardeum-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Shardeum MCP Server is a blockchain interaction tool for accessing the Shardeum network using standardized RPC methods.
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_blockNumbereth_getBlockByHasheth_getBlockByNumbereth_getBlockReceipts
-
Transaction Methods
eth_getTransactionCounteth_getTransactionByHasheth_getTransactionByBlockHashAndIndexeth_getTransactionByBlockNumberAndIndexeth_getTransactionReceipt
-
Account Methods
eth_getBalanceeth_estimateGaseth_chainId
Shardeum-Specific Methods
shardeum_getNodeListshardeum_getNetworkAccountshardeum_getCycleInfo
📦 Prerequisites
- Node.js 18.x or higher
- Basic understanding of blockchain technologies
Connecting with Cursor
- Clone the repo and do an npm install
- Open Cursor
- Go to Cursor Settings
- Scroll to "MCP"
- Click "Add new MCP server"
- 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
- Fork the repository
- Create a feature branch
- Commit changes
- Push to the branch
- 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!
