Skip to main content
Glama
deenesjakoruzh

mcp-nextcloud-calendar

by Cheffromspace
npmGitHub
TypeScript
ISC License
35
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Nextcloud 캘린더

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

특징

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

용법

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 서버 식별자넥스트클라우드 캘린더 서버아니요
노드_환경환경(개발/생산)개발아니요
넥스트클라우드베이스 URLNextcloud 서버 URL-예
다음 클라우드 사용자 이름Nextcloud 사용자 이름-예
넥스트클라우드 앱 토큰Nextcloud 앱 토큰-예
연결 유지 간격Keep-alive 간격(ms)30000아니요

개발 설정

지역 개발을 위해:

  1. 저장소를 복제합니다
  2. 종속성 설치:
npm install
  1. 프로젝트 루트에 .env 파일을 만듭니다.
cp .env.example .env
  1. Nextcloud 자격 증명으로 .env 파일을 편집합니다.

Nextcloud 앱 토큰 받기

  1. Nextcloud 인스턴스에 로그인하세요
  2. 설정 → 보안 → 앱 비밀번호로 이동하세요.
  3. "MCP Calendar"와 같은 이름으로 새 앱 비밀번호를 만드세요.
  4. 생성된 토큰을 .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 저장소에 보고해 주세요.

특허

아이에스씨

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

mcp-nextcloud-캘린더

  1. 특징
    1. 용법
      1. npx와 함께 사용
      2. 설치
      3. MCP 클라이언트 구성
    2. 구성
      1. 환경 변수
      2. 개발 설정
      3. Nextcloud 앱 토큰 받기
    3. 개발
      1. API 엔드포인트
        1. MCP 도구
          1. 캘린더 관리
          2. 이벤트 관리
        2. 알려진 문제 및 제한 사항
          1. 특허

            Related MCP Servers

            • Google Workspace MCP Server

              epaproditus
              A
              security
              A
              license
              A
              quality
              Provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
              Last updated -
              8
              13
              JavaScript
              MIT License

            • Cal.com Calendar MCP Server

              mumunha
              -
              security
              F
              license
              -
              quality
              An MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.
              Last updated -
              JavaScript

            • GoogleCalendarMCP

              ITworkonline
              -
              security
              F
              license
              -
              quality
              A Model Completion Prompt (MCP) plugin that allows users to create events in Google Calendar with customizable attributes like times, description, location, attendees, and timezone.
              Last updated -
              Python
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Cheffromspace/mcp-nextcloud-calendar'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server