Skip to main content
Glama
Kibela MCP Server

Kibela MCP Server

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

Версия НПМЗагрузки НПМ Лицензия: Массачусетский технологический институт значок кузнеца Сборка и отправка образа Docker Ворс

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

Функции

  • Поиск заметок с помощью расширенных фильтров

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

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

  • Управление группами и папками

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

  • Список пользователей

  • Просмотреть вложения к заметкам

  • Просмотреть недавно просмотренные заметки

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

Related MCP server: note.com MCP Server

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

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

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

  • KIBELA_TOKEN : ваш токен API Kibela (обязательно).

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

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

{
    "mcpServers": {
        "kibela": {
            "command": "npx",
            "args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

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

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

Инструменты

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 :

{
    "mcpServers": {
        "kibela": {
            "command": "node",
            "args": ["path/to/mcp-kibela-server/dist/src/index.js"],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

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

npx @modelcontextprotocol/inspector node ./dist/src/index.js

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

Докер

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

docker build -t mcp-kibela-server .

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

{
    "mcpServers": {
        "kibela": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "KIBELA_TEAM",
                "-e",
                "KIBELA_TOKEN",
                "mcp-kibela-server"
            ],
            "env": {
                "KIBELA_TEAM": "YOUR_TEAM_NAME",
                "KIBELA_TOKEN": "YOUR_TOKEN"
            }
        }
    }
}

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

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

Available Tools

12 tools
kibela_get_folder_notesC

Get notes in a folder

Inputs: folderId (required), limit.

kibela_get_group_foldersC

Get folders in a group

Inputs: groupId (required), parentFolderId.

kibela_get_group_notesB

Get notes in a group that are not attached to any folder

Inputs: groupId (required).

kibela_get_groupsB

Get list of accessible groups

Inputs: no named parameters.

kibela_get_my_notesA

Get your latest notes from Kibela

Inputs: limit.

kibela_get_note_contentC

Get content and comments of a specific note

Inputs: id (required), include_image_data.

kibela_get_note_from_pathC

Get note content by its URL

Inputs: path (required), include_image_data.

kibela_get_recently_viewed_notesB

Get your recently viewed notes

Inputs: limit.

kibela_get_usersC

Get list of users

Inputs: no named parameters.

kibela_like_noteC

Like a note

Inputs: noteId (required).

kibela_search_notesB

Search Kibela notes with given query

Inputs: query (required), coediting, isArchived, sortBy, +2 more.

kibela_unlike_noteC

Unlike a note

Inputs: noteId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but some overlap exists between tools that retrieve notes in different contexts (e.g., get_note_content vs get_note_from_path) and between personal note lists (get_my_notes vs get_recently_viewed_notes). Descriptions help disambiguate, so the set is mostly clear.

    Naming Consistency5/5

    All tools follow a consistent pattern: 'kibela_verb_noun' with present tense verbs. The naming is uniform and predictable, with no mixing of conventions.

    Tool Count5/5

    With 12 tools, the count is well-suited for a knowledge management server. It provides a balanced set of read operations, search, and simple interactions without being overwhelming or too sparse.

    Completeness2/5

    The tool set is heavily read-only, covering notes, folders, groups, and users, plus like/unlike. However, it lacks essential write operations such as creating, updating, or deleting notes or groups, which limits its completeness for typical workflows.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers