DAV MCP 服务器

通过 MCP 访问您的日历、联系人和文件！

介绍

该项目是一个模型上下文协议 (MCP) 服务器，允许您与 CalDAV、CardDAV 和 WebDAV 服务进行交互。它支持 Fastmail 和 Apple iCloud 帐户，可通过环境变量进行配置。

Related MCP server: Google Workspace MCP Server

设置

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 ：服务的应用专用密码。出于安全考虑，强烈建议使用应用专用密码。

MCP 配置

要使用此服务器，您需要在 MCP 配置文件中将其配置为mcpServer 。以下是示例：

{
  "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 客户端中与服务器定义交互的命令或功能来管理您的日历、联系人和文件。