Descripción general

Actualmente, Kibela MCP Server solo está disponible como servidor local mediante STDIO y se puede utilizar con cualquier cliente MCP como Claude Desktop o VSCode.

Sólo aquellas API GraphQL que están disponibles públicamente y son adecuadas para MCP se implementan como herramientas.

Related MCP server: MCP Toolkit

Casos de uso

• Pregunte por información en Kibela

• Organiza carpetas y artículos en Kibela

• Usando IA para ayudarte a escribir con Kibela

Requisitos

1. Docker está instalado

2. Docker debe estar ejecutándose

3. Se emiten tokens de acceso de Kibela

4. Se debe instalar una aplicación que implemente el cliente MCP

Instalación

Ejemplo: Claude Desktop

Escriba la siguiente configuración en claude_desktop_config.json . Establezca el origen y el token de acceso de Kibela como variables de entorno.

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

Sin Docker

A continuación, configure el script como comando de ejecución. En este punto, asegúrese de que la ruta al script sea absoluta.

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

Herramientas disponibles

Operaciones con notas

• search_kibela_note - Buscar notas

  • query : Palabra clave de búsqueda (obligatoria)

  • resources : Filtro de tipo de recurso (opcional)

  • coediting : Bandera de coedición (opcional)

  • updated : Actualizar rango de fechas (opcional)

  • groupIds : filtro de ID de grupo (opcional)

  • folderIds : filtro de ID de carpeta (opcional)

  • likerIds : filtro de ID de usuario Liker (opcional)

  • isArchived : Bandera de archivo (opcional)

  • sortBy : Orden de clasificación (opcional)

• get_kibela_note_by_relay_id - Obtener una nota por ID de retransmisión

  • id : ID de retransmisión de la nota (obligatorio)

• get_kibela_note_from_path_or_url - Obtener una nota de la ruta o URL

  • path : Ruta o URL de la nota (obligatorio)

• get_kibela_notes - Obtener notas en una carpeta

  • folderId : ID de carpeta (obligatorio)

  • first : Número de registros desde el frente (opcional)

  • last : Número de registros desde atrás (opcional)

• create_kibela_note - Crea una nueva nota

  • title : Título de la nota (obligatorio)

  • content : Contenido de la nota (obligatorio)

  • draft : Bandera de borrador (opcional)

  • groupIds : Lista de ID de grupos a los que pertenecer (obligatorio)

  • folders : Información de la carpeta (opcional)

    • groupId : ID de grupo

    • folderName : Nombre de la carpeta

• update_kibela_note_content - Actualizar el contenido de la nota

  • id la nota (obligatorio)

  • newContent : Nuevo contenido (obligatorio)

  • baseContent : Contenido original (obligatorio)

Operaciones de carpeta

• search_kibela_folder - Buscar carpetas

  • query : Palabra clave de búsqueda (obligatoria)

• get_kibela_folder_by_relay_id - Obtener una carpeta por ID de retransmisión

  • id : ID de retransmisión de la carpeta (obligatorio)

  • first : Número de registros desde el frente (opcional)

• get_kibela_folder_from_path_or_url - Obtener una carpeta desde la ruta o URL

  • path : Ruta o URL de la carpeta (obligatorio)

  • first : Número de registros desde el frente (opcional)

• get_kibela_folders - Obtener la lista de carpetas

  • first : Número de registros desde el frente (opcional)

  • last : Número de registros desde atrás (opcional)

• create_kibela_folder - Crea una nueva carpeta

  • groupId : ID del grupo (obligatorio)

  • fullName : Nombre completo de la ruta de la carpeta (obligatorio)

• move_kibela_note_to_another_folder - Mover una nota a otra carpeta

  • id la nota (obligatorio)

  • fromFolder : Información de la carpeta de origen (obligatoria)

    • groupId : ID de grupo

    • folderName : Nombre de la carpeta

  • toFolder : Información de la carpeta de destino (obligatoria)

    • groupId : ID de grupo

    • folderName : Nombre de la carpeta

• attach_kibela_note_to_folder - Asociar una nota a una carpeta

  • id la nota (obligatorio)

  • folder : Información de la carpeta (obligatoria)

    • groupId : ID de grupo

    • folderName : Nombre de la carpeta

Operaciones de comentarios

• create_kibela_comment - Crea un comentario en una nota

  • content : Comentar contenido (obligatorio)

  • noteId : ID de la nota de destino (obligatorio)

• create_kibela_comment_reply - Crea una respuesta a un comentario

  • content : Responder contenido (obligatorio)

  • commentId : ID del comentario de destino (obligatorio)

Otras operaciones

• get_kibela_groups - Obtener la lista de grupos

  • first : Número de registros desde el frente (opcional)

  • last : Número de registros desde atrás (opcional)

• get_kibela_feed_sections - Obtener la lista de secciones del feed

  • kind : Tipo de feed (obligatorio)

  • groupId : ID del grupo (obligatorio)

Indicaciones disponibles

Aviso de revisión

Toma una URL como entrada y revisa la nota especificada.

Esquema de entrada:

{
  url: string; // URL format
}

Solicitud de búsqueda

Toma una consulta como entrada y busca información relevante.

Esquema de entrada:

{
  query: string;
}

Aviso de nota relacionado

Toma una URL como entrada y explora la nota relacionada.

Esquema de entrada:

{
  url: string; // URL format
}

Indicación de comentario para reflexionar

Toma una URL como entrada y refleja su comentario a tener en cuenta.

Esquema de entrada:

{
  url: string; // URL format
}

Personalización

Puede personalizar la descripción y el mensaje de la herramienta preparando un archivo JSON en el siguiente formato.

Consulte server.ts para obtener claves de herramientas y de solicitud.

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

Y luego móntelo en el contenedor de la siguiente manera:

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

Desarrollo

docker compose run mcp pnpm install

docker compose up

Pruebas con MCP Inspector

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

Licencia

Este paquete está licenciado bajo los términos de la licencia MIT .