Kibela MCP Server

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

• vscode-Erweiterung für Kibela