Überblick

Kibela MCP Server ist derzeit nur als lokaler Server mit STDIO verfügbar und kann mit jedem MCP-Client wie Claude Desktop oder VSCode verwendet werden.

Als Tools werden nur öffentlich verfügbare und für MCP geeignete GraphQL-APIs implementiert.

Related MCP server: MCP Toolkit

Anwendungsfälle

• Fragen Sie nach Informationen in Kibela

• Ordner und Artikel in Kibela organisieren

• Verwenden Sie KI, um Ihnen beim Schreiben mit Kibela zu helfen

Anforderungen

1. Docker ist installiert

2. Docker muss ausgeführt werden

3. Kibela -Zugriffstoken werden ausgegeben

4. Eine Anwendung, die den MCP-Client implementiert, muss installiert sein

Installation

Beispiel: Claude Desktop

Schreiben Sie die folgende Konfiguration in claude_desktop_config.json . Legen Sie den Kibela-Ursprung und das Zugriffstoken als Umgebungsvariablen fest.

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

Kein Docker

Legen Sie dann das Skript als Ausführungsbefehl fest. Stellen Sie dabei sicher, dass der Pfad zum Skript absolut ist.

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

Verfügbare Tools

Hinweisvorgänge

• search_kibela_note – Notizen suchen

  • query : Suchbegriff (erforderlich)

  • resources : Ressourcentypfilter (optional)

  • Co- coediting : Co-Editing-Flag (optional)

  • updated : Datumsbereich aktualisieren (optional)

  • groupIds : Gruppen-ID-Filter (optional)

  • folderIds : Ordner-ID-Filter (optional)

  • likerIds : Liker-Benutzer-ID-Filter (optional)

  • isArchived : Archivierungsflag (optional)

  • sortBy : Sortierreihenfolge (optional)

• get_kibela_note_by_relay_id - Holen Sie sich eine Notiz per Relay-ID

  • id : Relay-ID der Notiz (erforderlich)

• get_kibela_note_from_path_or_url - Eine Notiz von einem Pfad oder einer URL abrufen

  • path : Pfad oder URL der Notiz (erforderlich)

• get_kibela_notes - Notizen in einem Ordner abrufen

  • folderId : Ordner-ID (erforderlich)

  • first : Anzahl der Datensätze von vorne (optional)

  • last : Anzahl der Datensätze von hinten (optional)

• create_kibela_note - Neue Notiz erstellen

  • title : Notiztitel (erforderlich)

  • content : Notizinhalt (erforderlich)

  • draft : Entwurfsflagge (optional)

  • groupIds : Liste der Gruppen-IDs, zu denen man gehören soll (erforderlich)

  • folders : Ordnerinformationen (optional)

    • groupId : Gruppen-ID

    • folderName : Ordnername

• update_kibela_note_content – Notizinhalt aktualisieren

  • id : Notiz-ID (erforderlich)

  • newContent : Neuer Inhalt (erforderlich)

  • baseContent : Originalinhalt (erforderlich)

Ordnervorgänge

• search_kibela_folder - Ordner durchsuchen

  • query : Suchbegriff (erforderlich)

• get_kibela_folder_by_relay_id - Einen Ordner per Relay-ID abrufen

  • id : Relay-ID des Ordners (erforderlich)

  • first : Anzahl der Datensätze von vorne (optional)

• get_kibela_folder_from_path_or_url - Einen Ordner aus einem Pfad oder einer URL abrufen

  • path : Ordnerpfad oder URL (erforderlich)

  • first : Anzahl der Datensätze von vorne (optional)

• get_kibela_folders - Ordnerliste abrufen

  • first : Anzahl der Datensätze von vorne (optional)

  • last : Anzahl der Datensätze von hinten (optional)

• create_kibela_folder - Einen neuen Ordner erstellen

  • groupId : Gruppen-ID (erforderlich)

  • fullName : Vollständiger Pfadname des Ordners (erforderlich)

• move_kibela_note_to_another_folder – Verschieben Sie eine Notiz in einen anderen Ordner

  • id : Notiz-ID (erforderlich)

  • fromFolder : Quellordnerinformationen (erforderlich)

    • groupId : Gruppen-ID

    • folderName : Ordnername

  • toFolder : Informationen zum Zielordner (erforderlich)

    • groupId : Gruppen-ID

    • folderName : Ordnername

• attach_kibela_note_to_folder - Verknüpft eine Notiz mit einem Ordner

  • id : Notiz-ID (erforderlich)

  • folder : Ordnerinformationen (erforderlich)

    • groupId : Gruppen-ID

    • folderName : Ordnername

Kommentarvorgänge

• create_kibela_comment - Einen Kommentar zu einer Notiz erstellen

  • content : Kommentarinhalt (erforderlich)

  • noteId : Zielnotiz-ID (erforderlich)

• create_kibela_comment_reply - Eine Antwort auf einen Kommentar erstellen

  • content : Antwortinhalt (erforderlich)

  • commentId : Zielkommentar-ID (erforderlich)

Andere Operationen

• get_kibela_groups - Gruppenliste abrufen

  • first : Anzahl der Datensätze von vorne (optional)

  • last : Anzahl der Datensätze von hinten (optional)

• get_kibela_feed_sections - Feed-Abschnittsliste abrufen

  • kind : Feed-Typ (erforderlich)

  • groupId : Gruppen-ID (erforderlich)

Verfügbare Eingabeaufforderungen

Überprüfungsaufforderung

Nimmt eine URL als Eingabe und überprüft die angegebene Notiz.

Eingabeschema:

{
  url: string; // URL format
}

Suchaufforderung

Nimmt eine Abfrage als Eingabe und sucht nach relevanten Informationen.

Eingabeschema:

{
  query: string;
}

Zugehörige Hinweisaufforderung

Nimmt eine URL als Eingabe und untersucht die zugehörige Notiz.

Eingabeschema:

{
  url: string; // URL format
}

Kommentaraufforderung reflektieren

Nimmt eine URL als Eingabe und gibt ihren Kommentar als Notiz wieder.

Eingabeschema:

{
  url: string; // URL format
}

Anpassung

Sie können die Toolbeschreibung und Eingabeaufforderung anpassen, indem Sie eine JSON-Datei im folgenden Format vorbereiten.

Tool- und Eingabeaufforderungsschlüssel finden Sie in server.ts .

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

Und dann montieren Sie es wie folgt am Container:

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

Entwicklung

docker compose run mcp pnpm install

docker compose up

Testen mit MCP Inspector

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

Lizenz

Dieses Paket ist unter den Bedingungen der MIT -Lizenz lizenziert.