Skip to main content
Glama
Kibela MCP Server

Kibela MCP Server

Servidor MCP de Kibela

Versión NPMDescargas de NPM Licencia: MIT insignia de herrería Construir y enviar una imagen de Docker Hilas

Implementación del servidor MCP para la integración de la API de Kibela, lo que permite que los LLM interactúen con el contenido de Kibela.

Características

  • Buscar notas con filtros avanzados

  • Obtenga sus últimas notas

  • Obtener contenido de notas y comentarios

  • Administrar grupos y carpetas

  • Notas de me gusta/no me gusta

  • Lista de usuarios

  • Ver notas adjuntas

  • Ver notas vistas recientemente

  • Obtener notas por ruta

Related MCP server: note.com MCP Server

Configuración

Variables de entorno

  • KIBELA_TEAM : El nombre de tu equipo Kibela (obligatorio)

  • KIBELA_TOKEN : Su token API de Kibela (obligatorio)

Integración del cursor

Añade a tu ~/.cursor/mcp.json :

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

Si desea utilizar Docker en su lugar

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

Herramientas

notas de búsqueda de kibela

Buscar notas de Kibela con la consulta dada

  • Aporte:

    • query (cadena): consulta de búsqueda

    • coediting (booleano, opcional): Filtrar por estado de coedición

    • isArchived (booleano, opcional): Filtrar por estado de archivo

    • sortBy (cadena, opcional): Ordenar por (RELEVANTE, CONTENIDO_ACTUALIZADO_EN)

    • userIds (string[], opcional): Filtrar por ID de usuario

    • folderIds (string[], opcional): Filtrar por ID de carpeta

  • Devuelve: Lista de notas coincidentes con ID, título, URL, autor, grupos y más

kibela_obtener_mis_notas

Obtén tus últimas notas de Kibela

  • Aporte:

    • limit (número, opcional): Número de notas a recuperar (predeterminado: 15)

  • Devoluciones: Lista de tus últimas notas con información del autor

kibela_obtener_contenido_de_nota

Obtener contenido y comentarios de una nota específica

  • Aporte:

    • id (cadena): ID de la nota

    • include_image_data (booleano, opcional): si se deben incluir las URL de datos de imágenes en la respuesta (valor predeterminado: falso)

  • Devoluciones: contenido completo de la nota, incluido HTML, comentarios, archivos adjuntos, grupos, carpetas y más

kibela_get_groups

Obtener lista de grupos accesibles

  • Entrada: Ninguna

  • Devoluciones: Lista de grupos con detalles como configuraciones de privacidad y permisos

kibela_get_group_folders

Obtener carpetas en un grupo

  • Aporte:

    • groupId (cadena): ID del grupo

    • parentFolderId (cadena, opcional): ID de la carpeta principal para carpetas anidadas

  • Devuelve: Lista de carpetas con sus notas y metadatos

kibela_obtener_notas_de_grupo

Obtener notas en un grupo que no estén adjuntas a ninguna carpeta

  • Aporte:

    • groupId (cadena): ID del grupo

  • Devoluciones: Lista de notas con información del autor, ordenadas por hora de última actualización

kibela_obtener_notas_de_carpeta

Obtener notas en una carpeta

  • Aporte:

    • folderId (cadena): ID de carpeta

  • Devoluciones: Lista de notas con información del autor, ordenadas por hora de última actualización

kibela_obtener_usuarios

Obtener lista de usuarios

  • Entrada: Ninguna

  • Devuelve: Listado de usuarios con ID, cuenta y nombre real

nota similar a kibela

Como una nota

  • Aporte:

    • noteId (cadena): ID de nota

  • Devoluciones: Lista de Me gusta actualizada

nota diferente de kibela

A diferencia de una nota

  • Aporte:

    • noteId (cadena): ID de nota

  • Devoluciones: Lista de Me gusta actualizada

kibela_obtener_notas_vistas_recientemente

Obtenga sus notas vistas recientemente

  • Aporte:

    • limit (número, opcional): Número de notas a recuperar (máximo 15)

  • Devoluciones: Lista de notas vistas recientemente con información del autor

kibela_obtener_nota_de_la_ruta

Obtener el contenido de la nota por su ruta o URL

  • Aporte:

    • path (cadena): ruta de la nota (por ejemplo, '/grupo/carpeta/nota') o URL completa de Kibela (por ejemplo, ' https://team.kibe.la/notes/123 ')

    • include_image_data (booleano, opcional): si se deben incluir las URL de datos de imágenes en la respuesta (valor predeterminado: falso)

  • Devoluciones: contenido completo de la nota, incluido HTML, comentarios, archivos adjuntos, grupos, carpetas y más

Desarrollo local

Corriendo desde la fuente

  1. Clonar el repositorio

  2. Instalar dependencias: npm install

Configuración del entorno

Para el desarrollo local, actualice su ~/.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"
            }
        }
    }
}

Inspector de MCP

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

y establecer entornos

Estibador

Construir y ejecutar localmente:

docker build -t mcp-kibela-server .

Luego use esta configuración:

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

Para el transporte SSE, asegúrese de que la URL del servidor esté configurada en: http://localhost:3000/sse

Otros productos

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