Servidor MCP de Kibela

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

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 :

Si desea utilizar Docker en su lugar

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 :

Inspector de MCP

y establecer entornos

Estibador

Construir y ejecutar localmente:

Luego use esta configuración:

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

Otros productos

• Extensión de vscode para Kibela