# HybridS3

Самохостящееся объектное хранилище с S3-совместимым API, обычным HTTP и MCP-интерфейсом. Пригодится, когда агенту нужно читать и писать файлы на своём сервере.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 5
- Автор: psyb0t
- Лицензия: WTFPL · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/psyb0t/docker-hybrids3
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/hybrids3

## Что делает

HybridS3 — это контейнер с `psyb0t/hybrids3`, который отдаёт три интерфейса к одним и тем же данным. `boto3` и AWS SDK работают как с обычным S3, `curl` ходит по HTTP, а ИИ-агенты подключаются через MCP и получают описания инструментов. Метаданные лежат в SQLite, сами объекты — плоскими файлами на диске.

Бакеты задаются в `config.yaml`, а не создаются через API. Что прописали, то и существует: конфиг версионируется, лишние бакеты не накапливаются. У каждого бакета свои ключи, флаг `public`, `ttl` и `max_file_size`. Есть `master_key` — он работает во всех бакетах и только он умеет перечислять их все.

Контейнер ждёт конфиг в `/config/config.yaml`, данные в `/data` и слушает порт `8080`, процесс идёт от UID 1000. Если ставите за nginx на подпуть, задайте `path_prefix` — иначе подпись AWS Sig V4 не сойдётся, потому что прокси срежет префикс, а сервер увидит другой путь. Без этого параметра сервер отдаёт маршруты от корня.

## Требования
- Нужно: Docker
- Работает с: Docker

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- дать агенту хранилище файлов без облачного аккаунта
- поднять S3-совместимый бэкенд для `boto3` за пару минут
- раздавать загруженные файлы публично, а остальное держать под ключом
- настроить автоудаление временных объектов через `ttl`
- ограничить размер загрузки на бакет и не ловить гигабайтные файлы

## Примеры запросов агенту
- Подключись к MCP-серверу HybridS3 и покажи, какие инструменты он даёт
- Загрузи `report.pdf` в бакет `uploads` через HybridS3
- Выведи список объектов в бакете `permanent`

## Похожие
- [backup-recovery](https://affpapa.org/nevibecode/skills/backup-recovery.md) — скилл · 406 установок
- [Backblaze B2 MCP Server](https://affpapa.org/nevibecode/mcp/backblaze-b2-mcp-server.md) — MCP-сервер · ★ 45
- [troubleshooting-s3-files](https://affpapa.org/nevibecode/skills/troubleshooting-s3-files.md) — скилл · 6300 установок
- [digitalocean-storage](https://affpapa.org/nevibecode/skills/digitalocean-storage.md) — скилл · 403 установки
- [aws-s3](https://affpapa.org/nevibecode/skills/aws-s3.md) — скилл · 345 установок
- [file-storage](https://affpapa.org/nevibecode/skills/file-storage.md) — скилл · 3100 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md