mcp-kibela 🗒️

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA buscar y referenciar contenido de Kibela. Esta configuración permite a modelos de IA como Claude acceder de forma segura a la información almacenada en Kibela.

Características 🚀

El servidor mcp-kibela ofrece las siguientes características:

Búsqueda de notas : Busque notas de Kibela por palabras clave
Mis notas : recupera tus últimas notas
Contenido de la nota : Obtenga el contenido de la nota y los comentarios por ID
Nota por ruta : obtener el contenido de la nota por ruta
Crear nota : Crea una nueva nota
Actualizar el contenido de la nota : Actualizar el contenido de la nota por ID de nota

Prerrequisitos 📋

Antes de comenzar, asegúrese de tener:

Node.js (v18 o superior)
Cliente MCP (Claude Desktop, Cursor, etc.)
Token de acceso de Kibela ( Cómo obtener un token )
Git (si se compila desde el código fuente)

Instalación 🛠️

Uso con cursor

{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

Uso con VSCode

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

Uso con Claude Desktop

{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

Uso de herrería

npx -y @smithery/cli install @kj455/mcp-kibela --client claude

Variables de entorno

Se requieren las siguientes variables de entorno:

KIBELA_TEAM : El nombre de tu equipo Kibela (obligatorio). Puedes encontrarlo en la URL de la página de tu equipo Kibela. Por ejemplo, https://[nombre-del-equipo].kibe.la
KIBELA_TOKEN : Su token API de Kibela (obligatorio)

Contribuyendo

¡Cualquier contribución será bienvenida!

Desarrollo

Utilice npm run build:watch para compilar el proyecto en modo de observación.

npm run build:watch

Utilice npx @modelcontextprotocol/inspector para inspeccionar el servidor MCP.

npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

Licencia 📄

Instituto Tecnológico de Massachusetts (MIT)

MCP Kibela