@idrivee2/s3-mcp
v0.1.3
Published
Model Context Protocol server for IDrive e2 S3-compatible object storage.
Maintainers
Readme
@idrivee2/s3-mcp
A local Model Context Protocol (MCP) server for managing IDrive e2 S3-compatible object storage. It provides an authenticated Streamable HTTP MCP endpoint with tools for regions, buckets, objects, multipart uploads, and presigned URLs.
Requirements
- Node.js 20 or newer
- An IDrive e2 account
Install
Install globally to use the command from any terminal:
npm install --global @idrivee2/s3-mcpOr install it in a Node.js project:
npm install @idrivee2/s3-mcpRun
After installation:
idrivee2-s3-mcpThe server starts in the background and prints its process ID, MCP URL, and log file. The default MCP URL is:
http://127.0.0.1:1908/s3Add this URL to an MCP client that supports Streamable HTTP and OAuth. The client will open the local IDrive e2 sign-in page when authentication is required.
Server commands
idrivee2-s3-mcp --status
idrivee2-s3-mcp --stop
idrivee2-s3-mcp --foreground
idrivee2-s3-mcp --foreground --debugParameters
| Parameter | Description |
| -------------------- | ---------------------------------------------------- |
| --web-port <port> | Login and OAuth port. Default: 1907 |
| --mcp-port <port> | MCP server port. Default: 1908 |
| --host <host> | Address used by both listeners. Default: 127.0.0.1 |
| --public-url <url> | Public HTTPS origin when using a reverse proxy |
| --data-dir <path> | Directory for encrypted local state |
| --cleanup | Delete encrypted local state and start fresh |
| --foreground | Keep the server attached to the terminal |
| --status | Show the background server status |
| --stop | Stop the background server |
| --debug | Enable diagnostic logging |
| -h, --help | Show command help |
| -v, --version | Show the package version |
Command-line parameters override environment variables.
IDrive e2 resources
License
UNLICENSED
