DAV MCP-сервер

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

Введение

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

Related MCP server: iCloud CalDAV MCP Connector

Настраивать

1. Предварительные условия : убедитесь, что у вас установлен Node.js.

2. Клонировать репозиторий : клонировать этот репозиторий на локальный компьютер.

3. Установка зависимостей : Перейдите в каталог проекта и запустите:

   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, которые взаимодействуют с определением сервера для управления вашими календарями, контактами и файлами.