MCP 服务器

0g-mcp-server

An MCP server enabling AI agents to interact with the 0G blockchain, including balance checks, transaction details, block info, and network statistics.

README

0G MCP Server 🚀

A Model Context Protocol (MCP) server for seamless AI agent integration with the 0G blockchain network. This server enables AI assistants to query blockchain data, check balances, retrieve transactions, and perform blockchain operations through natural language.

🌟 Tested and Production Ready - Successfully connects to live 0G testnet with real-time data

✨ Features

🔍 Balance Queries - Check wallet balances on 0G mainnet/testnet
📊 Transaction Lookup - Get detailed transaction information by hash
🧱 Block Information - Retrieve block details by number or hash
📈 Network Statistics - Live gas prices and network metrics
⛽ Gas Estimation - Calculate transaction costs
🌐 Multi-network Support - Seamless mainnet/testnet switching
🤖 AI-First Design - Built specifically for AI agent interactions

🚀 Quick Start

Prerequisites

Node.js 18+
npm or yarn
An MCP-compatible client (Claude Desktop, etc.)

1. Installation

# Clone the repository
git clone https://github.com/yourusername/0g-mcp-server.git
cd 0g-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

2. Test the Server

# Run the test suite
node test-server.js

# Expected output:
# ✅ Server initialization successful
# ✅ All 5 blockchain tools registered
# ✅ Live connection to 0G testnet confirmed

3. Configure Your MCP Client

For Claude Desktop:

Open your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
Add the 0G MCP server:

{
  "mcpServers": {
    "0g-blockchain": {
      "command": "node",
      "args": ["/full/path/to/0g-mcp-server/dist/index.js"]
    }
  }
}

Restart Claude Desktop

For Other MCP Clients:

Refer to your client's documentation for MCP server configuration.

4. Start Using!

Once configured, you can interact with the 0G blockchain through natural language:

"Check the balance of address 0x1234... on 0G testnet"
"Get details for transaction 0xabcd... on 0G mainnet"
"What's the current gas price on 0G network?"
"Show me block 4259504 information"

🛠️ Available Tools

Tool	Description	Required Parameters	Optional Parameters
`get_balance`	Get wallet balance	`address`	`network` (mainnet/testnet)
`get_transaction`	Transaction details by hash	`txHash`	`network`
`get_block`	Block information	`blockIdentifier`	`network`
`get_network_info`	Network statistics	-	`network`
`estimate_gas`	Gas cost estimation	`to`	`value`, `data`, `network`

💡 Usage Examples

Development Mode

npm run dev

Production Mode

npm start

Manual Testing

# Test specific functionality
node test-server.js

# Check server health
curl -X POST http://localhost:3000/health

🌐 Network Configuration

Network	RPC Endpoint	Chain ID	Explorer
Mainnet	`https://evmrpc-mainnet.0g.ai`	TBD	chainscan.0g.ai
Testnet	`https://evmrpc-testnet.0g.ai`	TBD	chainscan.0g.ai

🔧 Advanced Configuration

Environment Variables

Create a .env file for custom configuration:

# Custom RPC endpoints (optional)
ZG_MAINNET_RPC=https://your-custom-mainnet-rpc.com
ZG_TESTNET_RPC=https://your-custom-testnet-rpc.com

# Default network
DEFAULT_NETWORK=testnet

# Request timeout (ms)
REQUEST_TIMEOUT=30000

Custom Client Integration

import { ZGMCPServer } from './src/index.js';

const server = new ZGMCPServer({
  defaultNetwork: 'mainnet',
  customRpcEndpoints: {
    mainnet: 'https://your-rpc.com',
    testnet: 'https://your-testnet-rpc.com'
  }
});

await server.run();

🧪 Testing

The server includes comprehensive testing:

# Run all tests
npm test

# Test specific functionality
node test-server.js

# Test with live network
npm run test:live

Test Coverage:

✅ MCP protocol compliance
✅ All blockchain tools
✅ Network connectivity
✅ Error handling
✅ Live data retrieval

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Fork and clone the repo
git clone https://github.com/yourusername/0g-mcp-server.git

# Install dependencies
npm install

# Start development server
npm run dev

# Run tests
npm test