npm package: @0xdragon888/0g-mcp-server
Description: MCP Server for 0G Storage - Use decentralized storage in Claude Desktop
Author: 0G Labs
Latest version: 0.1.0

# @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:

```json
{
  "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:

```json
{
  "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

```bash
# 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](https://twitter.com/0GLabs)
- Discord: [0G Community](https://discord.gg/0glabs)

---

## License

MIT License - 0G Labs