Servidor MCP de Kibela

Versión NPM Descargas de NPM

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Permite la integración con la API de Kibela para buscar y recuperar notas, lo que permite que los LLM interactúen con el contenido de Kibela sin problemas.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Notes Server
truaxki
A
security
A
license
A
quality
An MCP server for managing and persisting notes, offering CRUD operations, note summarization, and resource-based access via a note:// URI scheme.
Last updated -
4
6
Python
MIT License
Tuya MCP Server
cabra-lat
-
security
A
license
-
quality
Provides a note storage system with a custom URI scheme and includes tools for adding notes and generating summaries for Tuya devices.
Last updated -
1
Python
MIT License
MCP Ollama Link
truaxki
-
security
F
license
-
quality
Facilitates initiating Ollama queries via Claude and manages a simple note storage system with capabilities to add, summarize, and access notes using custom URIs.
Last updated -
1
2
Python
Apple Notes MCP Server
Siddhant-K-code
A
security
A
license
A
quality
Enables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
Last updated -
3
2
TypeScript
MIT License

View all related MCP servers

Kibela MCP Server