# jahfer
## 基本信息
- Slug: `jahfer-dav-mcp-server`
- Source: modelscope
- Publisher: @jahfer/dav-mcp-server
- Categories: calendar-management / file-systems / cloud-storage
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@jahfer/dav-mcp-server
## 简介
暂无描述。
## MCP Server 详情

# DAV MCP 服务器

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

<a href="https://glama.ai/mcp/servers/@jahfer/dav-mcp-server">
  <img width="380" height="200" src="https://glama.ai/mcp/servers/@jahfer/dav-mcp-server/badge" alt="DAV 服务器 MCP 服务器" />
</a>

## 简介

该项目是一个 Model Context Protocol (MCP) 服务器，允许您与 CalDAV、CardDAV 和 WebDAV 服务进行交互。它支持 Fastmail 和 Apple iCloud 账户，并通过环境变量进行配置。

## 设置

1. **先决条件**：确保已安装 Node.js。
2. **克隆仓库**：将此仓库克隆到本地机器。
3. **安装依赖项**：导航到项目目录并运行：

    bash
    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`。以下是一个示例：

jsonc
{
  "mcpServers": {
    "myDavServices": {
      // 您可以随意命名
      "command": "npx", // 如果在 PATH 中，则可以直接使用 "node"
      "args": ["-y", "@jahfer/dav-mcp-server"], // 主脚本路径
      "env": {
        "DAV_PROVIDER": "icloud", // 或 "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 客户端中使用命令或功能与服务器定义进行交互，以管理您的日历、联系人和文件。