Kibela MCP Server
Сервер MCP Кибела
Реализация сервера 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, комментарии, вложения, группы, папки и многое другое.
Местное развитие
Работает из источника
Клонировать репозиторий
Установить зависимости:
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 toolskibela_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
Scored across 12 tools
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.
All tools follow a consistent pattern: 'kibela_verb_noun' with present tense verbs. The naming is uniform and predictable, with no mixing of conventions.
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.
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
Related MCP Connectors
Create, search and manage Knowtis collaborative notes from AI assistants.
Search and read your meeting notes, transcripts and action items, and create notes in Reline.
Search and read your own notes: insights, drafts, book and podcast notes. Read-only, OAuth.
Search, read, create and edit your Memol notes from Claude. Team note-taking with AI search.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.21MIT
- FlicenseCqualityBmaintenanceEnables interaction with note.com through API to search and read articles, manage posts and drafts, handle comments and likes, retrieve analytics, and access membership information.3432-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Notion workspaces through the Notion API, allowing them to search, read, create, update pages and databases, and manage comments using natural language commands.MIT
- AlicenseAqualityDmaintenanceEnables Claude Desktop to interact with KURA Notes API for semantic search, note creation, retrieval, and management. Supports natural language queries to search, create, retrieve, list, and delete notes with metadata like titles, tags, and annotations.5Elastic 2.0