Zerodrive Server

A Model Context Protocol (MCP) server for ZeroDrive file management. This server enables AI assistants like Claude to interact with ZeroDrive cloud storage through a standardized interface.

Features

• 28 MCP Tools across 4 categories:

  • File Operations (8 tools): List, get, upload, download, move, share files
  • Folder Operations (7 tools): Create, list, update, delete, move, share folders
  • Workspace Operations (10 tools): Manage collaborative workspaces with files and folders
  • Trash Operations (3 tools): List, restore, and empty trash

• Production-Ready:

  • Zod validation for all inputs
  • Structured logging with pino
  • Comprehensive error handling
  • TypeScript with strict mode

Requirements

• Node.js 22.0.0 or higher
• ZeroDrive API key

Installation

Via npm (Recommended)

npx @futurixai-labs/zerodrive-mcp-server

From Source

# Clone the repository
git clone https://github.com/futurixai/zerodrive-mcp-server.git
cd zerodrive-mcp-server

# Install dependencies
npm install

# Build
npm run build

Configuration

Set the required environment variable:

export ZERODRIVE_API_KEY="your-api-key-here"

Optional environment variables:

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "zerodrive": {
      "command": "npx",
      "args": ["@futurixai-labs/zerodrive-mcp-server"],
      "env": {
        "ZERODRIVE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

File Tools

Folder Tools

Workspace Tools

Trash Tools

Development

# Install dependencies
npm install

# Run type checking
npm run typecheck

# Build
npm run build

# Run linting
npm run lint

# Run tests
npm test

# Format code
npm run format

Project Structure

src/
├── index.ts              # Entry point
├── api/                  # HTTP client layer
│   ├── client.ts         # API client with auth
│   └── endpoints.ts      # API endpoint constants
├── config/               # Configuration
│   ├── env.ts            # Environment validation
│   └── constants.ts      # Application constants
├── errors/               # Error handling
│   └── base.ts           # Error classes
├── logging/              # Structured logging
│   └── logger.ts         # Pino logger setup
├── schemas/              # Zod validation schemas
│   ├── common.ts         # Shared schemas
│   ├── files.ts          # File tool schemas
│   ├── folders.ts        # Folder tool schemas
│   ├── workspaces.ts     # Workspace tool schemas
│   └── trash.ts          # Trash tool schemas
├── server/               # MCP server setup
│   ├── server.ts         # Server creation
│   └── handlers.ts       # Request handlers
├── tools/                # Tool implementations
│   ├── files/            # File tools
│   ├── folders/          # Folder tools
│   ├── workspaces/       # Workspace tools
│   ├── trash/            # Trash tools
│   └── registry.ts       # Tool dispatcher
├── types/                # TypeScript types
│   ├── entities.ts       # Domain types
│   └── api.ts            # API types
└── utils/                # Utilities
    ├── query-builder.ts  # URL query builder
    ├── request-builder.ts # Request body builder
    ├── upload-handler.ts # File upload logic
    └── response-formatter.ts # Response formatting

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

MIT License - see LICENSE for details.