CalDAV MCP Server

# Quick Start Guide ## Быстрый старт с uv ### 1. Установка uv **macOS/Linux:** ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` **Windows:** ```powershell powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" ``` ### 2. Установка зависимостей ```bash cd caldav uv sync --dev ``` Это создаст виртуальное окружение `.venv` и установит все зависимости. ### 3. Настройка переменных окружения Создайте файл `.env`: ```bash cat > .env << EOF CALDAV_URL=https://caldav.example.com/ CALDAV_USERNAME=your-username CALDAV_PASSWORD=your-password EOF ``` **Примечание**: Замените URL и учетные данные на ваши. Некоторые серверы (например, iCloud, Yandex) требуют app-specific пароли. Проверьте документацию вашего провайдера календаря. ### 4. Запуск сервера ```bash uv run mcp-caldav ``` Или с опциями: ```bash uv run mcp-caldav --verbose ``` ### 5. Запуск тестов ```bash make test # Unit tests make test-e2e # E2E tests (requires .env.e2e) make test-cov # With coverage ``` ## Полезные команды uv - `uv sync --dev` - Установить все зависимости (включая dev) - `uv sync` - Установить только production зависимости - `uv run <command>` - Запустить команду в виртуальном окружении - `uv add <package>` - Добавить новую зависимость - `uv remove <package>` - Удалить зависимость - `uv lock` - Обновить lock файл ## Использование без установки (uvx) Вы можете запустить сервер напрямую без установки: ```bash uvx mcp-caldav ``` Это автоматически установит и запустит сервер во временном окружении.