Сервер 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