Skip to main content
Glama
Kibela MCP Server

Kibela MCP Server

Kibela MCP Server

NPM-VersionNPM-Downloads Lizenz: MIT Schmiedeabzeichen Docker-Image erstellen und pushen Fussel

MCP-Serverimplementierung für die Kibela-API-Integration, die LLMs die Interaktion mit Kibela-Inhalten ermöglicht.

Merkmale

  • Notizen mit erweiterten Filtern durchsuchen

  • Holen Sie sich Ihre neuesten Notizen

  • Notizinhalte und Kommentare abrufen

  • Verwalten von Gruppen und Ordnern

  • Notizen mögen/nicht mögen

  • Benutzer auflisten

  • Notizanhänge anzeigen

  • Zuletzt angezeigte Notizen anzeigen

  • Notizen nach Pfad abrufen

Related MCP server: note.com MCP Server

Konfiguration

Umgebungsvariablen

  • KIBELA_TEAM : Ihr Kibela-Teamname (erforderlich)

  • KIBELA_TOKEN : Ihr Kibela-API-Token (erforderlich)

Cursor-Integration

Fügen Sie zu Ihrer ~/.cursor/mcp.json hinzu:

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

Wenn Sie stattdessen Docker verwenden möchten

{
    "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"
            }
        }
    }
}

Werkzeuge

kibela_search_notes

Durchsuchen Sie Kibela-Notizen mit der angegebenen Abfrage

  • Eingang:

    • query (Zeichenfolge): Suchanfrage

    • coediting (Boolesch, optional): Filtern nach Co-Editing-Status

    • isArchived (Boolesch, optional): Filtern nach Archivstatus

    • sortBy (Zeichenfolge, optional): Sortieren nach (RELEVANT, CONTENT_UPDATED_AT)

    • userIds (string[], optional): Filtern nach Benutzer-IDs

    • folderIds (string[], optional): Filtern nach Ordner-IDs

  • Gibt zurück: Liste der übereinstimmenden Notizen mit ID, Titel, URL, Autor, Gruppen und mehr

kibela_get_my_notes

Holen Sie sich Ihre neuesten Notizen von Kibela

  • Eingang:

    • limit (Zahl, optional): Anzahl der abzurufenden Notizen (Standard: 15)

  • Rückgabe: Liste Ihrer neuesten Notizen mit Autoreninformationen

kibela_get_note_content

Inhalte und Kommentare einer bestimmten Notiz abrufen

  • Eingang:

    • id (Zeichenfolge): Notiz-ID

    • include_image_data (boolesch, optional): Ob Bilddaten-URLs in die Antwort aufgenommen werden sollen (Standard: „false“)

  • Rückgabe: Vollständiger Notizinhalt einschließlich HTML, Kommentare, Anhänge, Gruppen, Ordner und mehr

kibela_get_groups

Liste der zugänglichen Gruppen abrufen

  • Eingabe: Keine

  • Gibt zurück: Liste der Gruppen mit Details wie Datenschutzeinstellungen und Berechtigungen

kibela_get_group_folders

Ordner in einer Gruppe abrufen

  • Eingang:

    • groupId (Zeichenfolge): Gruppen-ID

    • parentFolderId (Zeichenfolge, optional): Übergeordnete Ordner-ID für verschachtelte Ordner

  • Rückgabe: Liste der Ordner mit ihren Notizen und Metadaten

kibela_get_group_notes

Notizen in einer Gruppe abrufen, die keinem Ordner zugeordnet sind

  • Eingang:

    • groupId (Zeichenfolge): Gruppen-ID

  • Rückgabe: Liste der Notizen mit Autoreninformationen, sortiert nach dem Zeitpunkt der letzten Aktualisierung

kibela_get_folder_notes

Notizen in einem Ordner abrufen

  • Eingang:

    • folderId (Zeichenfolge): Ordner-ID

    • limit (Zahl, optional): Anzahl der abzurufenden Notizen (Standard: 100)

  • Rückgabe: Liste der Notizen mit Autoreninformationen, sortiert nach dem Zeitpunkt der letzten Aktualisierung

kibela_get_users

Liste der Benutzer abrufen

  • Eingabe: Keine

  • Rückgabe: Liste der Benutzer mit ID, Konto und echtem Namen

kibela_like_note

Wie eine Notiz

  • Eingang:

    • noteId (Zeichenfolge): Notiz-ID

  • Rückgabe: Aktualisierte Liker-Liste

kibela_unlike_note

Im Gegensatz zu einer Notiz

  • Eingang:

    • noteId (Zeichenfolge): Notiz-ID

  • Rückgabe: Aktualisierte Liker-Liste

kibela_get_recently_viewed_notes

Holen Sie sich Ihre zuletzt angezeigten Notizen

  • Eingang:

    • limit (Zahl, optional): Anzahl der abzurufenden Notizen (max. 15)

  • Gibt zurück: Liste der zuletzt angezeigten Notizen mit Autoreninformationen

kibela_get_note_from_path

Abrufen von Notizinhalten über den Pfad oder die URL

  • Eingang:

    • path (Zeichenfolge): Notizpfad (z. B. „/group/folder/note“) oder vollständige Kibela-URL (z. B. „ https://team.kibe.la/notes/123 “)

    • include_image_data (boolesch, optional): Ob Bilddaten-URLs in die Antwort aufgenommen werden sollen (Standard: „false“)

  • Rückgabe: Vollständiger Notizinhalt einschließlich HTML, Kommentare, Anhänge, Gruppen, Ordner und mehr

Lokale Entwicklung

Ausführen von der Quelle

  1. Klonen Sie das Repository

  2. Abhängigkeiten installieren: npm install

Umgebungs-Setup

Aktualisieren Sie für die lokale Entwicklung Ihre ~/.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"
            }
        }
    }
}

MCP-Inspektor

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

und Umgebungen festlegen

Docker

Lokal erstellen und ausführen:

docker build -t mcp-kibela-server .

Verwenden Sie dann diese Konfiguration:

{
    "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"
            }
        }
    }
}

Stellen Sie für den SSE-Transport sicher, dass die Server-URL auf http://localhost:3000/sse eingestellt ist.

Andere Produkte

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