0g Chain MCP

🔗 0G链MCP服务器v0.1.0

用于0G链区块链操作的生产就绪模型上下文协议（MCP）服务器

特性 • 快速开始 • 工具 • 提示 • 安全 • 贡献

______________________________________________________________________

🚀 特性

⛓️ 0G链集成

• 本机0G令牌操作（发送、余额检查）
• 质押和委托管理
• 验证器发现和分析
• 具有自动复合支持的奖励跟踪
• 以太坊兼容钱包生成
• 与0G链主网直接交互

🏗️ 双服务器架构

• 用于REST API访问的HTTP服务器（Express）
• 用于Claude Desktop集成的MCP stdio服务器
• 两台服务器之间无缝通信
• 具有优雅关机功能的流程管理
• 健康监测端点

🛠️ 专业结构

• 带有独立tools.js的模块化工具系统
• 专用utils.js文件中的实用程序助手
• 清晰地分离关注点
• 易于扩展和维护
• 生产测试组件

🔧 开发者友好

• 简单的JSON-RPC接口
• 全面的错误处理
• 基于环境的配置
• Docker容器化支持
• MCP协议2024-11-05的实施
• 零配置部署，具有合理的默认值

🎯 9强大的工具

• 钱包创建和管理
• 余额检查和代币转账
• 打桩/拆桩作业
• 验证信息和发现
• 奖励跟踪和计算
• Explorer集成

______________________________________________________________________

📦 快速开始

✅ 先决条件

# Required
Node.js >= 18.0.0
npm >= 9.0.0

🔑 配置

创建一个 .env 项目根目录中的文件（可选-默认为0G主网）：

# 0G Chain Configuration (defaults to Mainnet if not specified)
OG_RPC_URL=https://evmrpc.0g.ai
OG_CHAIN_ID=16661

# Wallet Configuration (required for transactions)
WALLET_PRIVATE_KEY=your_private_key_here
WALLET_ADDRESS=your_wallet_address_here

# HTTP Server Configuration
PORT=8080

注： WALLET_PRIVATE_KEY 和 WALLET_ADDRESS 仅在交易操作（发送、质押、撤销质押）中需要。没有它们，只读操作也能工作。

📥 安装

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

# Install dependencies
npm install

# Configure environment (optional)
cp .env.example .env
# Edit .env with your wallet credentials (if needed)

# Start the HTTP server
npm start

# MCP stdio server for Claude Desktop
npm run mcp

🤖 Claude桌面集成

要在Claude Desktop中配置MCP服务器，请执行以下操作：

1. 打开克劳德桌面应用程序
2. 点击 设置 （齿轮图标）
3. 导航至 开发者 标签
4. 点击 编辑配置 按钮
5. 将以下配置添加到MCP服务器：

{
  "mcpServers": {
    "0g-chain": {
      "command": "node",
      "args": ["/absolute/path/to/0g-chain-mcp/mcp/index.js"],
      "env": {
        "OG_RPC_URL": "https://evmrpc.0g.ai",
        "OG_CHAIN_ID": "16661",
        "WALLET_PRIVATE_KEY": "your_private_key_here",
        "WALLET_ADDRESS": "your_wallet_address_here"
      }
    }
  }
}

1. 保存配置并重新启动Claude Desktop

安全说明： 仅添加 WALLET_PRIVATE_KEY 如果你打算通过克劳德进行交易。对于只读操作，可以省略它。

______________________________________________________________________

🛠 可用工具

🔐 钱包管理

💰 余额和转账

🎯 打桩作业

📊 验证器发现

______________________________________________________________________

🤖 提示

💬 克劳德提示示例

钱包操作

"Create a new 0G Chain wallet for me"
"Check my 0G balance"
"What's the balance of address 0x..."
"Send 10 0G tokens to 0x..."

打桩作业

"Show me all available 0G validators"
"Get detailed information about validator 0x..."
"Stake 1 0G token to validator 0x..."
"What are my accumulated rewards from validator 0x...?"
"Unstake 0.5 0G from validator 0x..."
"Unstake all my tokens from validator 0x..."

分析与研究

"Compare all validators and their commission rates"
"Which validator has the best APY?"
"How much would I earn staking 10 0G for a year?"
"Show me my current staking positions"
"Calculate my rewards if I originally staked 5 0G"

🌐 HTTP API测试

# List available tools
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

# Check balance
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "get_balance", "arguments": {}}, "id": 1}'

# Get validators list
curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "get_validators_list", "arguments": {"include_details": false}}, "id": 1}'

______________________________________________________________________

🔒 安全

🛡️ 安全最佳实践

• 私钥保护 -永不承诺 .env Git的文件或私钥
• 环境变量 -仅在环境变量中存储敏感数据（私钥）
• 默认情况下为只读 -大多数工具在没有私钥的情况下工作，以实现最大的安全性
• 输入验证 -所有地址和金额在处理前都经过验证
• 错误处理 -错误不会暴露敏感信息
• 安全RPC -使用HTTPS进行所有区块链通信
• 浏览器集成 -在0G链浏览器上验证所有交易

⚠️ 重要提示

• 21天解除绑定期：未锁定的代币在提款前被锁定21天
• 自动复合奖励：奖励会自动复合到您的赌注中（无需单独索赔）
• 提款费：解除锁定时收取的小额费用（由验证器设置）
• 佣金率：验证人对质押奖励收取佣金（通常为5-10%）
• 天然气费：所有交易都需要0G代币来支付汽油费

______________________________________________________________________

🚀 部署

🏭 生产部署

# Start production server
NODE_ENV=production npm start

# With PM2
pm2 start server.js --name 0g-chain-mcp

# With Docker
docker build -t 0g-chain-mcp .
docker run -d -p 8080:8080 --env-file .env 0g-chain-mcp

🔑 环境变量

# 0G Chain Network Configuration
OG_RPC_URL=https://evmrpc.0g.ai
OG_CHAIN_ID=16661

# Wallet Configuration (optional for read-only operations)
WALLET_PRIVATE_KEY=your_private_key_here
WALLET_ADDRESS=your_wallet_address_here

# Server Configuration
PORT=8080
NODE_ENV=production

# Advanced Settings (optional)
RATE_LIMIT_REQUESTS_PER_SECOND=10

______________________________________________________________________

🤝 贡献

我们欢迎捐款！请阅读 贡献.md 了解我们开发过程的详细信息。

# Fork the repository
git clone https://github.com/Tairon-ai/0g-chain-mcp.git

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes and commit
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature

# Open Pull Request

______________________________________________________________________

📊 0G链信息

🌐 网络详细信息

• 网络名称：0G链主网
• 链ID: 16661
• RPC URL: https://evmrpc.0g.ai
• 探索者: https://explorer.0g.ai/mainnet
• 链式扫描仪: https://chainscan.0g.ai
• 质押合同：0xea224dB52F57752044c0C86aD509309091F561B9

______________________________________________________________________

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

📚 资源

• MCP协议规范
• 0G链文档
• ethers.js文档
• Express.js文档

______________________________________________________________________

建造于 Tairon.ai 在克劳德的帮助下