DAV MCP Server

DAV MCP 服务器

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

介绍

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

设置

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 。以下是示例：

可用工具

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