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:

Variable	Default	Description
ZERODRIVE_BASE_URL	https://drive.futurixai.com	API base URL
LOG_LEVEL	info	Log level (trace, debug, info, warn, error, fatal, silent)
NODE_ENV	production	Environment mode

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

Tool	Description
list_files	List files with filtering, pagination, and sorting
get_file	Get detailed file metadata
upload_file	Upload a file from local path
download_file	Generate download URL for a file
generate_signed_url	Generate time-limited signed URL
fetch_file_content	Fetch text content of a file
move_file	Move file to different folder
share_file	Share file with other users

Folder Tools

Tool	Description
list_folders	List folders with filtering and pagination
create_folder	Create a new folder
get_folder	Get folder details
update_folder	Update folder properties
delete_folder	Delete folder (to trash or permanent)
move_folder	Move folder to different parent
share_folder	Share folder with other users

Workspace Tools

Tool	Description
list_workspaces	List all accessible workspaces
create_workspace	Create a new workspace
get_workspace	Get workspace details
upload_workspace_file	Upload file to workspace
list_workspace_files	List files in workspace
list_workspace_folders	List folders in workspace
create_workspace_folder	Create folder in workspace
get_workspace_folder	Get workspace folder details
update_workspace_folder	Update workspace folder
delete_workspace_folder	Delete workspace folder

Trash Tools

Tool	Description
list_trash	List trashed items
restore_from_trash	Restore item from trash
empty_trash	Permanently delete all trashed items

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.