DAV MCP 서버

MCP를 통해 캘린더, 연락처, 파일에 접근하세요!

소개

이 프로젝트는 CalDAV, CardDAV, WebDAV 서비스와 연동할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 환경 변수를 통해 설정된 Fastmail 및 Apple iCloud 계정을 모두 지원합니다.

Related MCP server: iCloud CalDAV MCP Connector

설정

1. 필수 조건 : Node.js가 설치되어 있는지 확인하세요.

2. 저장소 복제 : 이 저장소를 로컬 머신에 복제합니다.

3. 종속성 설치 : 프로젝트 디렉토리로 이동하여 다음을 실행합니다.

   지엑스피1

   이것을 글로벌 명령으로 게시하거나 사용하려는 경우 설치 후 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 클라이언트 내에서 서버 정의와 상호 작용하는 명령이나 기능을 사용하여 캘린더, 연락처 및 파일을 관리할 수 있습니다.