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 :

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

Clonar el repositorio
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

Extensión de vscode para Kibela

Kibela MCP Server