MCP Nextcloud 캘린더

Nextcloud Calendar 통합을 위한 MCP(Model Context Protocol) 서버입니다.

특징

Nextcloud에서 캘린더 가져오기
ADHD 친화적인 조직 특징
MCP 프로토콜 지원(스트리밍 가능 HTTP 및 레거시 HTTP+SSE)

Related MCP server: mcp-server-cloudbrowser

용법

npx와 함께 사용

이 패키지를 사용하는 가장 쉬운 방법은 npx를 사용하는 것입니다.

지엑스피1

설치

개발 또는 로컬 설치의 경우:

# Install globally
npm install -g mcp-nextcloud-calendar

# Or install locally
npm install mcp-nextcloud-calendar

MCP 클라이언트 구성

MCP 클라이언트(예: Claude)와 함께 사용하려면 MCP 클라이언트 설정에 다음 구성을 추가하세요.

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

버전 지정

패키지의 특정 버전을 고정할 수 있습니다.

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-nextcloud-calendar@0.1.0"],
      "env": {
        "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_APP_TOKEN": "your-app-token"
      }
    }
  }
}

구성

환경 변수

서버는 가능한 경우 기본값을 사용하여 다음과 같은 환경 변수를 사용합니다.

변하기 쉬운	설명	기본	필수의
포트	서버 포트	3001	아니요
서버 이름	MCP 서버 식별자	넥스트클라우드 캘린더 서버	아니요
노드_환경	환경(개발/생산)	개발	아니요
넥스트클라우드베이스 URL	Nextcloud 서버 URL	-	예
다음 클라우드 사용자 이름	Nextcloud 사용자 이름	-	예
넥스트클라우드 앱 토큰	Nextcloud 앱 토큰	-	예
연결 유지 간격	Keep-alive 간격(ms)	30000	아니요

개발 설정

지역 개발을 위해:

저장소를 복제합니다
종속성 설치:

npm install

프로젝트 루트에 .env 파일을 만듭니다.

cp .env.example .env

Nextcloud 자격 증명으로 .env 파일을 편집합니다.

Nextcloud 앱 토큰 받기

Nextcloud 인스턴스에 로그인하세요
설정 → 보안 → 앱 비밀번호로 이동하세요.
"MCP Calendar"와 같은 이름으로 새 앱 비밀번호를 만드세요.
생성된 토큰을 .env 파일에 복사하세요.

개발

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm run test

# Run linting
npm run lint

# Format code
npm run format

API 엔드포인트

/mcp - 기본 MCP 엔드포인트(스트리밍 가능한 HTTP 전송)
/sse 및 /messages - 레거시 MCP 엔드포인트(HTTP+SSE 전송)
GET /health - 상태 확인 엔드포인트
GET /api/calendars - 모든 캘린더 나열

MCP 도구

다음 MCP 도구는 등록되어 클라이언트가 사용할 수 있습니다.

캘린더 관리

도구	설명	매개변수
`listCalendars`	접근 가능한 모든 달력을 검색합니다	없음
`createCalendar`	새 달력을 만듭니다	`displayName` (필수), `color` (선택 사항), `category` (선택 사항), `focusPriority` (선택 사항)
`updateCalendar`	기존 달력을 업데이트합니다	`id` (필수), `displayName` (선택 사항), `color` (선택 사항), `category` (선택 사항), `focusPriority` (선택 사항)
`deleteCalendar`	달력을 삭제합니다	`id` (필수)

⚠️ 권한 경고 : updateCalendar 및 deleteCalendar 도구는 Nextcloud 인스턴스에서 특별 권한이 필요할 수 있습니다. 캘린더 작업은 Nextcloud의 권한 시스템을 따릅니다.

이벤트 관리

도구	설명	매개변수
`listEvents`	달력의 이벤트를 검색합니다	`calendarId` (필수), `start` (선택), `end` (선택)
`getEvent`	특정 이벤트를 가져옵니다	`calendarId` (필수), `eventId` (필수)
`createEvent`	새로운 이벤트를 생성합니다	`calendarId` (필수), `summary` (필수), `start` (필수), `end` (필수), `description` (선택 사항), `location` (선택 사항)
`updateEvent`	기존 이벤트를 업데이트합니다	`calendarId` (필수), `eventId` (필수), [업데이트할 이벤트 속성 포함]
`deleteEvent`	이벤트를 삭제합니다	`calendarId` (필수), `eventId` (필수)

알려진 문제 및 제한 사항

참고 : 이 패키지는 현재 초기 개발 단계(0.1.x)입니다. API와 도구는 향후 릴리스에서 예고 없이 변경될 수 있습니다.

캘린더 업데이트 및 삭제 작업에는 Nextcloud 인스턴스에서 특정 권한이 필요할 수 있습니다.
특정 Nextcloud 오류 코드에 대한 오류 처리가 계속 개선되고 있습니다.
많은 이벤트가 있는 대형 달력에서는 성능 문제가 발생할 수 있습니다.

문제가 있으면 GitHub 저장소에 보고해 주세요.

특허

아이에스씨

mcp-nextcloud-calendar