Kibela MCP Server

Official
by kibela

Integrations

  • Provides containerized deployment of the MCP server through Docker, with environment variable configuration for Kibela authentication.

  • Interacts with Kibela through its GraphQL API, allowing operations like searching notes, managing folders, creating and updating notes, and handling comments within the Kibela knowledge management platform.

  • Supports development setup using pnpm package manager, with commands for installation and dependency management.

Обзор

Kibela MCP Server в настоящее время доступен только как локальный сервер с использованием STDIO и может использоваться с любым клиентом MCP, таким как Claude Desktop или VSCode.

В качестве инструментов реализованы только те API GraphQL, которые общедоступны и подходят для MCP.

Варианты использования

  • Спросите об информации в Кибеле
  • Организуйте папки и статьи в Kibela
  • Использование ИИ для помощи в написании текстов с помощью Kibela

Требования

  1. Докер установлен
  2. Docker должен быть запущен
  3. Выпущены токены доступа Kibela
  4. Необходимо установить приложение, реализующее клиент MCP.

Установка

Пример: Клод Десктоп

Запишите следующую конфигурацию в claude_desktop_config.json . Установите источник Kibela и токен доступа как переменные среды.

{ "mcpServers": { "kibela": { "command": "docker", "args": [ "run", "-i", "-e", "KIBELA_ORIGIN", "-e", "KIBELA_ACCESS_TOKEN", "ghcr.io/kibela/kibela-mcp-server" ], "env": { "KIBELA_ORIGIN": "https://your-subdomain.kibe.la", "KIBELA_ACCESS_TOKEN": "***" } } } }

Нет Докера

Затем установите скрипт как команду выполнения. В это время убедитесь, что путь к скрипту абсолютный.

{ "mcpServers": { "kibela": { "command": "/path/to/kibela-mcp-server/bin/cli.mjs", "env": { "KIBELA_ORIGIN": "https://your-subdomain.kibe.la", "KIBELA_ACCESS_TOKEN": "***" } } } }

Доступные инструменты

Примечание Операции

  • search_kibela_note - Поиск заметок
    • query : Ключевое слово поиска (обязательно)
    • resources : Фильтр типа ресурса (необязательно)
    • coediting : флаг совместного редактирования (необязательно)
    • updated : диапазон дат обновления (необязательно)
    • groupIds : фильтр идентификатора группы (необязательно)
    • folderIds : Фильтр идентификаторов папок (необязательно)
    • likerIds : фильтр идентификатора пользователя лайкера (необязательно).
    • isArchived : Флаг архива (необязательно)
    • sortBy : порядок сортировки (необязательно)
  • get_kibela_note_by_relay_id — Получить заметку по идентификатору реле
    • id идентификатор реле заметки (обязательно)
  • get_kibela_note_from_path_or_url — Получить заметку из пути или URL
    • path : Путь или URL заметки (обязательно)
  • get_kibela_notes - Получить заметки в папке
    • folderId : Идентификатор папки (обязательно)
    • first : Количество записей с начала (необязательно)
    • last : Количество записей с конца (необязательно)
  • create_kibela_note - Создать новую заметку
    • title : Заголовок заметки (обязательно)
    • content : Примечание к содержанию (обязательно)
    • draft : Флаг проекта (необязательно)
    • groupIds : список идентификаторов групп, к которым нужно принадлежать (обязательно)
    • folders : информация о папке (необязательно)
      • groupId : идентификатор группы
      • folderName : Имя папки
  • update_kibela_note_content — Обновить содержимое заметки
    • id : Идентификатор заметки (обязательно)
    • newContent : Новый контент (обязательно)
    • baseContent : Оригинальный контент (обязательно)

Операции с папками

  • search_kibela_folder - Поиск папок
    • query : Ключевое слово поиска (обязательно)
  • get_kibela_folder_by_relay_id — Получить папку по идентификатору реле
    • id Идентификатор ретранслятора папки (обязательно)
    • first : Количество записей с начала (необязательно)
  • get_kibela_folder_from_path_or_url — Получить папку из пути или URL
    • path : Путь к папке или URL (обязательно)
    • first : Количество записей с начала (необязательно)
  • get_kibela_folders - Получить список папок
    • first : Количество записей с начала (необязательно)
    • last : Количество записей с конца (необязательно)
  • create_kibela_folder - Создать новую папку
    • groupId : идентификатор группы (обязательно)
    • fullName : Полный путь к папке (обязательно)
  • move_kibela_note_to_another_folder — Переместить заметку в другую папку
    • id : Идентификатор заметки (обязательно)
    • fromFolder : Информация об исходной папке (обязательно)
      • groupId : идентификатор группы
      • folderName : Имя папки
    • toFolder : Информация о папке назначения (обязательно)
      • groupId : идентификатор группы
      • folderName : Имя папки
  • attach_kibela_note_to_folder — привязать заметку к папке
    • id : Идентификатор заметки (обязательно)
    • folder : Информация о папке (обязательно)
      • groupId : идентификатор группы
      • folderName : Имя папки

Операции по комментарию

  • create_kibela_comment - Создать комментарий к заметке
    • content : Комментарий к содержанию (обязательно)
    • noteId : Идентификатор целевой заметки (обязательно)
  • create_kibela_comment_reply — Создать ответ на комментарий
    • content : Ответить содержание (обязательно)
    • commentId : Идентификатор целевого комментария (обязательно)

Другие операции

  • get_kibela_groups - Получить список групп
    • first : Количество записей с начала (необязательно)
    • last : Количество записей с конца (необязательно)
  • get_kibela_feed_sections - Получить список разделов ленты
    • kind : Тип подачи (обязательно)
    • groupId : идентификатор группы (обязательно)

Доступные подсказки

Запрос на обзор

Принимает URL-адрес в качестве входных данных и просматривает указанную заметку.

Схема ввода:

{ url: string; // URL format }

Поисковая подсказка

Принимает запрос в качестве входных данных и ищет соответствующую информацию.

Схема ввода:

{ query: string; }

Связанная заметка Подсказка

Принимает URL-адрес в качестве входных данных и исследует связанную заметку.

Схема ввода:

{ url: string; // URL format }

Отразить комментарий Подсказка

Принимает URL-адрес в качестве входных данных и отображает его комментарий в заметке.

Схема ввода:

{ url: string; // URL format }

Настройка

Вы можете настроить описание инструмента и подсказку, подготовив JSON-файл в следующем формате.

Ключи инструментов и подсказок см. в файле server.ts .

{ "tools": { "search_kibela_note": { "description": "New description" } }, "prompts": { "review": { "prompt": "New review prompt" } } }

А затем прикрепите его к контейнеру следующим образом:

{ "mcpServers": { "kibela": { "command": "docker", "args": [ "run", "-i", "-e", "KIBELA_ORIGIN", "-e", "KIBELA_ACCESS_TOKEN", "-v", "/path/to/kibela-mcp-server-config.json:/usr/src/app/kibela-mcp-server-config.json", "ghcr.io/kibela/kibela-mcp-server" ], "env": { "KIBELA_ORIGIN": "https://your-subdomain.kibe.la", "KIBELA_ACCESS_TOKEN": "***" } } } }

Разработка

docker compose run mcp pnpm install
docker compose up

Тестирование с помощью MCP Inspector

npx @modelcontextprotocol/inspector \ -e KIBELA_ORIGIN=https://your-subdomain.kibe.la \ -e KIBELA_ACCESS_TOKEN=*** \ docker compose exec mcp bin/cli.mjs

Лицензия

Данный пакет лицензирован в соответствии с условиями лицензии MIT .

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер Model Context Protocol, который позволяет приложениям ИИ взаимодействовать с базами знаний Kibela, позволяя пользователям искать, создавать, обновлять и организовывать контент с помощью естественного языка.

  1. Варианты использования
    1. Требования
      1. Установка
        1. Пример: Клод Десктоп
        2. Нет Докера
      2. Доступные инструменты
        1. Примечание Операции
        2. Операции с папками
        3. Операции по комментарию
        4. Другие операции
      3. Доступные подсказки
        1. Запрос на обзор
        2. Поисковая подсказка
        3. Связанная заметка Подсказка
        4. Отразить комментарий Подсказка
      4. Настройка
        1. Разработка
          1. Тестирование с помощью MCP Inspector
        2. Лицензия

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
            Last updated -
            9
            Python
            MIT License
          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that enables AI models to interact with SourceSync.ai's knowledge management platform for managing documents, ingesting content from various sources, and performing semantic searches.
            Last updated -
            25
            14
            • Apple
            • Linux
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that provides AI assistants with structured access to your Logseq knowledge graph, enabling retrieval, searching, analysis, and creation of content within your personal knowledge base.
            Last updated -
            19
            TypeScript
            • Apple
          • -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.
            Last updated -
            55
            TypeScript
            MIT License

          View all related MCP servers

          ID: 6utn596w3i