Kibela MCP Server

Сервер MCP Кибела

Реализация сервера MCP для интеграции API Kibela, позволяющая магистрам права взаимодействовать с контентом Kibela.

Функции

• Поиск заметок с помощью расширенных фильтров
• Получите ваши последние заметки
• Получить содержание заметки и комментарии
• Управление группами и папками
• Нравится/не нравится заметки
• Список пользователей
• Просмотреть вложения к заметкам
• Просмотреть недавно просмотренные заметки
• Получить заметки по пути

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

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

• KIBELA_TEAM : Название вашей команды Kibela (обязательно)
• KIBELA_TOKEN : ваш токен API Kibela (обязательно).

Интеграция курсора

Добавьте в ваш ~/.cursor/mcp.json :

Если вы хотите использовать Docker вместо этого

Инструменты

kibela_search_notes

Поиск заметок Кибелы по заданному запросу

• Вход:
  • query (строка): Поисковый запрос
  • coediting (логическое значение, необязательно): Фильтр по статусу совместного редактирования
  • isArchived (логическое значение, необязательно): Фильтр по статусу архива
  • sortBy (строка, необязательно): Сортировать по (RELEVANT, CONTENT_UPDATED_AT)
  • userIds (string[], необязательно): Фильтр по идентификаторам пользователей
  • folderIds (string[], необязательно): Фильтр по идентификаторам папок
• Возвращает: список соответствующих заметок с идентификатором, заголовком, URL, автором, группами и т. д.

kibela_get_my_notes

Получите последние заметки от Кибелы

• Вход:
  • limit (число, необязательно): количество заметок для извлечения (по умолчанию: 15)
• Возвращает: список ваших последних заметок с информацией об авторе.

kibela_get_note_content

Получить содержание и комментарии к определенной заметке

• Вход:
  • id (строка): Идентификатор заметки
  • include_image_data (логическое значение, необязательно): включать ли URL-адреса данных изображений в ответ (по умолчанию: false)
• Возвращает: полное содержимое заметки, включая HTML, комментарии, вложения, группы, папки и многое другое.

kibela_get_groups

Получить список доступных групп

• Ввод: нет
• Возвращает: список групп с подробностями, такими как настройки конфиденциальности и разрешения.

kibela_get_group_folders

Получить папки в группе

• Вход:
  • groupId (строка): идентификатор группы
  • parentFolderId (строка, необязательно): идентификатор родительской папки для вложенных папок.
• Возвращает: список папок с их примечаниями и метаданными.

kibela_get_group_notes

Получайте заметки в группе, которые не прикреплены ни к одной папке

• Вход:
  • groupId (строка): идентификатор группы
• Возвращает: список заметок с информацией об авторе, отсортированный по времени последнего обновления.

kibela_get_folder_notes

Получить заметки в папке

• Вход:
  • folderId (строка): идентификатор папки
  • limit (число, необязательно): количество заметок для извлечения (по умолчанию: 100)
• Возвращает: список заметок с информацией об авторе, отсортированный по времени последнего обновления.

kibela_get_users

Получить список пользователей

• Ввод: нет
• Возвращает: список пользователей с идентификатором, учетной записью и настоящим именем.

kibela_like_note

Нравится заметка

• Вход:
  • noteId (строка): идентификатор заметки
• Возвращает: обновленный список лайков

kibela_unlike_note

В отличие от заметки

• Вход:
  • noteId (строка): идентификатор заметки
• Возвращает: обновленный список лайков

kibela_get_recently_viewed_notes

Получите недавно просмотренные заметки

• Вход:
  • limit (число, необязательно): количество заметок для извлечения (макс. 15)
• Возвращает: список недавно просмотренных заметок с информацией об авторе.

kibela_get_note_from_path

Получить содержимое заметки по ее пути или URL

• Вход:
  • path (строка): путь к заметке (например, '/group/folder/note') или полный URL-адрес Kibela (например, ' https://team.kibe.la/notes/123 ')
  • include_image_data (логическое значение, необязательно): включать ли URL-адреса данных изображений в ответ (по умолчанию: false)
• Возвращает: полное содержимое заметки, включая HTML, комментарии, вложения, группы, папки и многое другое.

Местное развитие

Работает из источника

1. Клонировать репозиторий
2. Установить зависимости: npm install

Настройка среды

Для локальной разработки обновите ~/.cursor/mcp.json :

инспектор МКП

и установить окружение

Докер

Сборка и запуск локально:

Тогда используйте эту конфигурацию:

Для транспорта SSE убедитесь, что URL-адрес сервера установлен следующим образом: http://localhost:3000/sse

Другие продукты

• расширение vscode для kibela