Servidor DAV MCP

¡Acceda a sus calendarios, contactos y archivos a través de MCP!

Introducción

Este proyecto es un servidor de Protocolo de Contexto de Modelo (MCP) que permite interactuar con los servicios CalDAV, CardDAV y WebDAV. Es compatible con cuentas de Fastmail y Apple iCloud, configuradas mediante variables de entorno.

Related MCP server: iCloud CalDAV MCP Connector

Configuración

1. Requisitos previos : asegúrese de tener Node.js instalado.

2. Clonar el repositorio : clona este repositorio en tu máquina local.

3. Instalar dependencias : navegue al directorio del proyecto y ejecute:

   npm install

   Si desea publicar o usar esto como un comando global, también puede ejecutar npm link después de la instalación o instalarlo globalmente a través de npm install -g . (una vez que package.json esté configurado para la instalación global, si lo desea).

Configuración de variables de entorno

Para conectarse a sus servicios DAV, debe configurar las siguientes variables de entorno al ejecutar la aplicación:

• DAV_PROVIDER : Especifica su proveedor de servicios DAV. Configure como fastmail o icloud (sin distinción entre mayúsculas y minúsculas).

• DAV_USERNAME : Su nombre de usuario para el servicio (por ejemplo, su dirección de correo electrónico de Fastmail o ID de Apple).

• DAV_PASSWORD : Contraseña específica de la aplicación para el servicio. Se recomienda usar contraseñas específicas de la aplicación por seguridad.

Configuración de MCP

Para usar este servidor, debe configurarlo como mcpServer en su archivo de configuración de MCP. A continuación, se muestra un ejemplo:

{
  "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"
      }
    }
  }
}

Herramientas disponibles

Una vez configurado, este servidor MCP proporciona las siguientes herramientas:

Calendario (CalDAV)

• get_my_calendars : enumera todos los calendarios disponibles.

• get_calendar_events : Obtiene eventos de un calendario específico. Opcionalmente, puede proporcionar una fecha y hora de inicio y fin para filtrar eventos dentro de un rango específico.

Contactos (CardDAV)

• get_my_contact_lists : enumera todas sus libretas de direcciones de contactos.

• get_contacts_from_list : obtiene contactos de una libreta de direcciones especificada.

Archivos (WebDAV - principalmente para Fastmail)

• list_my_files_and_folders : enumera archivos y carpetas dentro de una ruta específica en su almacenamiento WebDAV (por defecto, la raíz).

• get_file_or_folder_details : obtiene metadatos para una URL de archivo o carpeta determinada.

Uso

Después de configurar el servidor MCP en su configuración, puede usar comandos o funciones dentro de su cliente MCP que interactúan con la definición del servidor para administrar sus calendarios, contactos y archivos.