zerodrive

ZeroDrive MCP Server exposes a standardized set of MCP tools that allow AI assistants to interact with ZeroDrive cloud storage. It implements 28 tools across four categories: File Operations (list, get, upload, download, move, share, and others), Folder Operations (create, list, update, delete, move, share), Workspace Operations (managing collaborative workspaces with files and folders), and Trash Operations (list, restore, empty). The server uses Zod for input validation, structured logging with Pino, and strict TypeScript, offering robust error handling for reliable automation. To use it, deploy the MCP server (via npm npx command) and configure your Claude Desktop or other MCP-enabled client to point at the server, providing your API key as an environment variable. The provided Claude Desktop example shows how to add zerodrive to claude_desktop_config.json with env protection for the API key. Tools are grouped by category in the tool reference, enabling your AI to perform common cloud storage tasks such as listing files, uploading files, generating signed URLs, managing workspaces, and trash operations like restoration or permanent deletion.

Prerequisites:

• Node.js 22.0.0 or higher
• npm (bundled with Node.js)

Installation steps:

1. Install and run the MCP server via npm:

# Quick start using npx (recommended)
npx @futurixai-labs/zerodrive-mcp-server

2. If installing from source, clone the repository, install dependencies, and build:

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

# Install dependencies
npm install

# Build the project
npm run build

3. Set up required environment variables, notably your API key:

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

Optional environment variables can tailor behavior:

• ZERODRIVE_BASE_URL: API base URL (default: https://drive.futurixai.com)
• LOG_LEVEL: log level (default: info)
• NODE_ENV: environment mode (default: production)

4. Run the server (if not using npx, depending on your setup):

# Example if building locally
node dist/index.js

Tips and common issues:

• Ensure ZERODRIVE_API_KEY is available to the MCP server process; consider exporting it in your environment or configuring it via your IPC/CLI tooling.
• If you customize base URLs or endpoints, set ZERODRIVE_BASE_URL accordingly to avoid authentication or routing errors.
• The server uses strict input validation (Zod); if tools fail, check the input payloads against the tool schemas in src/schemas to debug malformed requests.
• For Claude integration, use the provided configuration snippet to register the MCP server; ensure the environment variable is securely provided in Claude's config.
• Monitor logs using the LOG_LEVEL setting; use trace or debug temporarily when diagnosing issues.
• When building from source, run typecheck, lint, and tests to ensure code quality before deployment.