Hybrid S3 MCP Server

Lightweight object storage that speaks S3 (boto3/AWS SDK compatible), plain HTTP, and MCP. SQLite for metadata, flat files on disk. Its 7 documented tools cluster into read & search, create & write, download, delete.

People who work with api storage, aws s3 and docker and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Shell.

VERIFIED ACTIVE

LAST COMMIT 2026-08-01 · ★ 4 · #140 OF 153 MAINTAINED CLOUD INFRASTRUCTURE · VERIFIED 2026-09-18

WTFPL · Shell · how we verify → /methodology

01 · Install Hybrid S3

before you install - you'll need

The README does not document required environment variables for a basic install.

Docker

docker run -i --rm docker.io/psyb0t/hybrids3:v0.3.8

Claude Desktop - add to config

{
  "mcpServers": {
    "psyb0t-docker-hybrids3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/psyb0t/hybrids3:v0.3.8"
      ]
    }
  }
}
Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license WTFPL - declared in the repository

registry namespace io.github.psyb0t is GitHub-verified and matches the repo owner

03 · What Hybrid S3 can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can upload text or base64-encoded binary. Content type auto-detected if not specified, download object content. Returns text or base64-encoded binary. Objects over 50 MB cannot be downloaded via MCP - use the HTTP API directly, delete an object, and list objects with optional prefix filter. Default 100 results, max 1000.

Capability map

Tools grouped from the project's README - what Hybrid S3 lets an agent do.

read & search

2 tools - e.g. List objects with optional prefix filter. Default 100 results, max 1000.; Master key lists all buckets. Bucket key lists only that bucket.

list_objects · list_buckets

create & write

1 tool - e.g. Upload text or base64-encoded binary. Content type auto-detected if not specified.

upload_object

Download

1 tool - e.g. Download object content. Returns text or base64-encoded binary. Objects over 50 MB cannot be downloaded via MCP - use the HTTP API directly.

download_object

delete

1 tool - e.g. Delete an object.

delete_object

Object

1 tool - e.g. Get object metadata (size, content type, ETag, expiry time) without downloading the content.

object_info

Presign

1 tool - e.g. Generate a shareable URL. Pass method="GET" (default) or method="PUT". GET on a public bucket returns a plain URL; everything else is a signed expiring URL.

presign_url

Limitations (from the README)

- No multipart upload (S3's chunked upload protocol) - No object versioning - No ACLs beyond bucket-level public/private - No bucket creation or deletion via API - buckets are defined in config - No CORS headers - add these at the reverse proxy layer if needed - No replication - No encryption at rest

Latest releases

v0.3.8 · 2026-08-01

v0.3.7 · 2026-07-27

v0.3.6 · 2026-07-27

04 · Who maintains Hybrid S3

HybridS3 is maintained by psyb0t. We track 13 MCP servers from psyb0t - 13 actively maintained, 126 combined GitHub stars, oldest repo from Jun 2025. Full record: all servers from psyb0t.

  1. Stealthy Auto Browse Self-hosted MCP server for stealth browser automation with human-like OS-level input. ★ 81
  2. Claudebox Self-hosted MCP server exposing Claude Code as an agentic AI tool over streamable HTTP. ★ 21
  3. Talkies Self-hosted MCP server for speech: ASR transcription, TTS synthesis, and file staging tools. ★ 5
  4. Pibox Self-hosted MCP server: pi-coding-agent tools (run_prompt, file ops) over streamable HTTP. ★ 2
  5. Audiolla Self-hosted MCP server: audio stems, mastering, MIR analysis, DSP, MIDI, speech tools. ★ 3
  6. Predictalot Self-hosted MCP server for time-series forecasting and tabular ML via foundation models. ★ 2

05 · Facts

category
cloud infrastructure - ranked #140 of 153 actively-maintained cloud infrastructure servers as of 2026-09-18.
release cadence
10+ releases in the last 90 days (latest 2026-08-01)
registry
io.github.psyb0t/hybrids3 (active, first published 2026-07-26 · 6 versions)
packages
oci:docker.io/psyb0t/hybrids3:v0.3.8

06 · Hybrid S3 FAQ

Is Hybrid S3 still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-01 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Hybrid S3 do?

With this server connected, an agent can upload text or base64-encoded binary. Content type auto-detected if not specified, download object content. Returns text or base64-encoded binary. Objects over 50 MB cannot be downloaded via MCP - use the HTTP API directly, delete an object, and list objects with optional prefix filter. Default 100 results, max 1000.

How do I install Hybrid S3?

Run `docker run -i --rm docker.io/psyb0t/hybrids3:v0.3.8`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

07 · Alternatives to Hybrid S3

More cloud infrastructure MCP servers · Talkies · DynamoDB · Fly Io · GCS · S3 (pulsemcp)