DAV MCP-сервер

Name: DAV MCP Server
Author: jahfer

Получите доступ к своим календарям, контактам и файлам через MCP!

Введение

Этот проект представляет собой сервер Model Context Protocol (MCP), который позволяет вам взаимодействовать с вашими службами CalDAV, CardDAV и WebDAV. Он поддерживает как учетные записи Fastmail, так и Apple iCloud, настроенные через переменные среды.

Related MCP server: Google Workspace MCP Server

Настраивать

Предварительные условия : убедитесь, что у вас установлен Node.js.
Клонировать репозиторий : клонировать этот репозиторий на локальный компьютер.
Установка зависимостей : Перейдите в каталог проекта и запустите:
npm install
Если вы собираетесь опубликовать или использовать это как глобальную команду, вы также можете запустить npm link после установки или установить ее глобально с помощью npm install -g . (после настройки package.json для глобальной установки, если это необходимо).

Конфигурация переменных среды

Для подключения к службам DAV вам необходимо установить следующие переменные среды при запуске приложения:

DAV_PROVIDER : Указывает вашего поставщика услуг DAV. Установите fastmail или icloud (без учета регистра).
DAV_USERNAME : Ваше имя пользователя для сервиса (например, ваш адрес электронной почты Fastmail или Apple ID).
DAV_PASSWORD : Пароль приложения для сервиса. Настоятельно рекомендуется использовать пароли приложения для безопасности.

Конфигурация МКП

Чтобы использовать этот сервер, вам нужно настроить его как mcpServer в вашем файле конфигурации MCP. Вот пример:

{ "mcpServers": { "myDavServices": { // You can name this anything you like "command": "npx", // Or simply "node" if it's in your PATH "args": ["-y", "@jahfer/dav-mcp-server"], // Path to the main script "env": { "DAV_PROVIDER": "icloud", // or "fastmail" "DAV_USERNAME": "your-username", "DAV_PASSWORD": "your-app-specific-password" } } } }

Доступные инструменты

После настройки этот сервер MCP предоставляет следующие инструменты:

Календарь (CalDAV)

get_my_calendars : выводит список всех доступных календарей.
get_calendar_events : Извлекает события из указанного календаря. Вы можете дополнительно указать начальную и конечную дату/время для фильтрации событий в определенном диапазоне.

Контакты (CardDAV)

get_my_contact_lists : выводит список всех ваших адресных книг.
get_contacts_from_list : Извлекает контакты из указанной адресной книги.

Файлы (WebDAV — в первую очередь для Fastmail)

list_my_files_and_folders : выводит список файлов и папок по указанному пути в хранилище WebDAV (по умолчанию — в корневом каталоге).
get_file_or_folder_details : извлекает метаданные для указанного URL-адреса файла или папки.

Использование

После настройки сервера MCP в вашей конфигурации вы можете использовать команды или функции в вашем клиенте MCP, которые взаимодействуют с определением сервера для управления вашими календарями, контактами и файлами.