DAV MCP サーバー

MCP 経由でカレンダー、連絡先、ファイルにアクセスしましょう。

導入

このプロジェクトは、CalDAV、CardDAV、WebDAVサービスとの連携を可能にするモデルコンテキストプロトコル（MCP）サーバーです。環境変数で設定されたFastmailとApple iCloudアカウントの両方をサポートします。

Related MCP server: Google Workspace MCP Server

設定

前提条件: Node.js がインストールされていることを確認してください。
リポジトリのクローンを作成する: このリポジトリをローカルマシンにクローンします。
依存関係をインストールします。プロジェクトディレクトリに移動して、次を実行します。
```
npm install
```
これをグローバルコマンドとして公開または使用する場合、インストール後にnpm linkを実行するか、 npm install -g .でグローバルにインストールすることもできます (必要に応じて、 package.jsonグローバルインストール用に構成した後)。

環境変数の設定

DAV サービスに接続するには、アプリケーションの実行時に次の環境変数を設定する必要があります。

DAV_PROVIDER : DAVサービスプロバイダを指定します。fastmailまたはicloud （大文字と小文字は区別されませんfastmailに設定してください。
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 のメタデータを取得します。