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

Календарь MCP Nextcloud

Сервер протокола контекста модели (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	Нет

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

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

Клонировать репозиторий
Установить зависимости:

npm install

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

cp .env.example .env

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

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

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

Инструмент	Описание	Параметры
`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

Integrations