Календарь MCP Nextcloud

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

Функции

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

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

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

Related MCP server: ical-mcp

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

Использование с 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"
      }
    }
  }
}

Конфигурация

Переменные среды

Сервер использует следующие переменные среды, где это возможно, со значениями по умолчанию:

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

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

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

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

npm install

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

cp .env.example .env

4. Отредактируйте файл .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 зарегистрированы и доступны клиентам:

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

⚠️ Предупреждение о разрешениях : инструменты updateCalendar и deleteCalendar могут потребовать специальных разрешений в вашем экземпляре Nextcloud. Операции с календарем подчиняются системе разрешений Nextcloud.

Управление мероприятиями

Известные проблемы и ограничения

Примечание : этот пакет в настоящее время находится на ранней стадии разработки (0.1.x). API и инструменты могут быть изменены без уведомления в будущих выпусках.

• Для операций обновления и удаления календаря могут потребоваться особые разрешения в вашем экземпляре Nextcloud.

• Обработка ошибок для определенных кодов ошибок Nextcloud все еще совершенствуется.

• Большие календари с большим количеством событий могут вызывать проблемы с производительностью.

Пожалуйста, сообщайте о любых проблемах в репозитории GitHub.

Лицензия

МСК