Skip to main content
Glama
deenesjakoruzh

mcp-nextcloud-calendar

by Cheffromspace
npmGitHub
TypeScript
ISC License
26
6
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Календарь MCP Nextcloud

npm-версия Лицензия: ISC

Сервер протокола контекста модели (MCP) для интеграции календаря Nextcloud.

Функции

  • Получить календари из Nextcloud

  • Особенности организации, благоприятные для людей с СДВГ

  • Поддержка протокола MCP (потоковый HTTP и устаревший HTTP+SSE)

Использование

Использование с npx

Самый простой способ использовать этот пакет — с помощью npx:

npx mcp-nextcloud-calendar

Установка

Для разработки или локальной установки:

# 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

nextcloud-календарь-сервер

Нет

NODE_ENV

Окружающая среда (разработка/производство)

разработка

Нет

NEXTCLOUD_BASE_URL

URL вашего сервера Nextcloud

-

Да

NEXTCLOUD_USERNAME

Ваше имя пользователя Nextcloud

-

Да

NEXTCLOUD_APP_TOKEN

Ваш токен приложения Nextcloud

-

Да

KEEP_ALIVE_INTERVAL

Интервал проверки активности (мс)

30000

Нет

Настройка разработки

Для местного развития:

  1. Клонировать репозиторий

  2. Установить зависимости:

npm install

  1. Создайте файл .env в корне проекта:

cp .env.example .env

  1. Отредактируйте файл .env , используя свои учетные данные Nextcloud.

Получение токена приложения 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 зарегистрированы и доступны клиентам:

Управление календарем

Инструмент

Описание

Параметры

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?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

mcp-nextcloud-календарь

  1. Функции
    1. Использование
      1. Использование с npx
      2. Установка
      3. Конфигурация клиента MCP
    2. Конфигурация
      1. Переменные среды
      2. Настройка разработки
      3. Получение токена приложения Nextcloud
    3. Разработка
      1. Конечные точки API
        1. Инструменты МКП
          1. Управление календарем
          2. Управление мероприятиями
        2. Известные проблемы и ограничения
          1. Лицензия

            Related MCP Servers

            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