Обзор

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

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

Related MCP server: MCP Toolkit

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

• Спросите об информации в Кибеле

• Организуйте папки и статьи в 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 .