Nextcloud MCP

Краткое назначение

Nextcloud MCP — MCP-сервер для управления файлами и публичными ссылками в Nextcloud через WebDAV и OCS API.

Бизнес-задача

Nextcloud часто используется как приватное файловое хранилище для документов, отчетов и рабочих материалов. Проект дает AI-ассистентам контролируемый интерфейс к этому хранилищу: читать структуру папок, загружать файлы, переносить документы и создавать ссылки без ручной работы в веб-интерфейсе.

Техническое решение

Сервер публикует набор MCP-инструментов поверх Nextcloud API. Поддержаны операции с файлами, папками, поиском и shares. Для бинарных файлов есть отдельные сценарии загрузки через base64 и локальный streaming upload для файлов больше 5 MB.

Архитектура

MCP stdio server;
WebDAV adapter для файловых операций;
OCS Share API adapter для публичных ссылок и shares;
typed tool layer для AI-клиентов;
env-based конфигурация подключения;
file logging с уровнями debug, info, warn, error.

Стек

Node.js 18+, TypeScript, MCP SDK, axios, fast-xml-parser, mime-types, Nextcloud WebDAV, OCS API.

Интеграции

Nextcloud 25+;
Claude Desktop;
Claude Code;
OpenAI Codex;
другие MCP-compatible clients.

Ограничения и риски

Для production-использования критичны app password, минимальные права доступа и аккуратное хранение переменных окружения. Коммерческое использование требует отдельного согласования, потому что проект заявлен под CC BY-NC 4.0.

Что показывает в портфолио

Практическую AI-интеграцию с self-hosted storage, работу с WebDAV/OCS API, безопасную конфигурацию и сценарии автоматизации документов.