@0xdragon888/0g-mcp-server

Use 0G decentralized storage directly in Claude Desktop.

Store your notes, code snippets, and data on the blockchain - just by chatting with Claude.

Quick Start

1. Configure Claude Desktop

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following:

{
  "mcpServers": {
    "0g-storage": {
      "command": "npx",
      "args": ["-y", "@0xdragon888/0g-mcp-server"]
    }
  }
}

2. Restart Claude Desktop

Close and reopen Claude Desktop to load the new MCP server.

3. Start Using

Now you can talk to Claude about storing and retrieving data:

Upload content:

"Save this note to 0G storage: Meeting notes for Jan 30..."

List your files:

"Show me what I've stored on 0G"

Download content:

"Get my file with ID 0x..."

That's it! No coding required.

What Can You Do?

| Say to Claude | What Happens | |---------------|--------------| | "Upload this text to 0G" | Stores your content on decentralized storage | | "Save this code snippet permanently" | Stores code with filename | | "What files do I have on 0G?" | Lists all your uploaded content | | "Download my file from 0G" | Retrieves previously stored content |

Available Tools

| Tool | Description | |------|-------------| | upload_to_0g | Upload text, code, or any content to 0G Storage | | list_my_files | View all your stored files with details | | download_from_0g | Retrieve content using blob ID or link |

Example Conversations

Upload a Note

You: Please save this to 0G storage:

     # Project Ideas
     - Build a decentralized app
     - Learn Rust

Claude: I've uploaded your content to 0G Storage!

        Blob ID: 0x8f3e2c1a...
        Link: https://0g.ai/view/0x8f3e2c1a...
        Size: 58 bytes

        You can share this link with anyone!

List Your Files

You: Show me what I've stored on 0G

Claude: Here are your files on 0G Storage:

        1. project-ideas.md (58 bytes)
           Uploaded: 2026-01-30 10:30 AM
           Link: https://0g.ai/view/0x8f3e2c1a...

        2. meeting-notes.txt (1.2 KB)
           Uploaded: 2026-01-30 09:15 AM
           Link: https://0g.ai/view/0x7d2b1f9e...

Why 0G Storage?

• Decentralized: Your data is stored on a blockchain network, not a single server
• Permanent: Content is stored permanently and can't be deleted
• Verifiable: Every upload has cryptographic proof
• Fast: Built for high-performance AI workloads

Advanced Configuration

You can customize the server with environment variables:

{
  "mcpServers": {
    "0g-storage": {
      "command": "npx",
      "args": ["-y", "@0xdragon888/0g-mcp-server"],
      "env": {
        "ZERO_G_RPC_URL": "https://rpc-testnet.0g.ai",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

| Variable | Description | Default | |----------|-------------|---------| | ZERO_G_RPC_URL | 0G network RPC endpoint | https://rpc-testnet.0g.ai | | LOG_LEVEL | Logging level (debug/info/warn/error) | info |

Development

# Clone and install
git clone https://github.com/0glabs/0g-mcp-server.git
cd 0g-mcp-server
pnpm install

# Development mode
pnpm dev

# Build
pnpm build

# Test
pnpm test

Troubleshooting

"MCP server not found"

• Make sure you restarted Claude Desktop after editing the config
• Check that the config file path is correct for your OS

"Tool not working"

• Check Claude Desktop logs for errors
• Try running npx @0xdragon888/0g-mcp-server directly in terminal to see output

Support

• GitHub Issues: https://github.com/0glabs/0g-mcp-server/issues
• Twitter: @0GLabs
• Discord: 0G Community

License

MIT License - 0G Labs