🗞️ bome-navaja

Servidor MCP para el Boletín Oficial de la Ciudad Autónoma de Melilla (BOME)

Pregunta por el BOME en lenguaje natural: lista boletines, lee artículos y PDF completos, busca en vivo con la misma lógica que el sitio, consulta al instante un índice local de sumarios y llega hasta 1985 con el portal antiguo de melilla.es.

📑 Índice

Related MCP server: BOE & EUR-Lex MCP Server

🧭 Qué es

bome-navaja es un programa local que tu cliente de IA (Claude Desktop, Claude Code…) lanza en tu máquina y con el que habla por el protocolo MCP. Le da al modelo acceso a bomemelilla.es: el calendario de boletines, el árbol de artículos de cada boletín, el texto completo de artículos y boletines, los PDF, el buscador del sitio y un índice local de sumarios para búsquedas instantáneas.

Cobertura (la de bomemelilla.es):

Para lo anterior a 2018, y para todo lo anterior a 2014, está el portal antiguo de melilla.es: boletines del 3 de enero de 1985 al 12 de marzo de 2021, con sumarios de artículos desde ~1991 y el PDF de cada página. Sus sumarios de 1991–2017 también se pueden guardar en el índice local.

bome-navaja solo lee datos públicos: no inicia sesión, no usa credenciales y no envía nada al sitio más allá de las consultas.

🧰 Herramientas

Todas devuelven un objeto con ok. Si algo falla devuelven ok: false, un error en castellano y un error_code estable (no_encontrado, cve_invalido, busqueda_invalida, lectura_invalida, argumento_invalido, error_http, sitio_bloqueando, pausa_preventiva, indice_no_disponible, y para el portal antiguo url_pdf_invalida y boletin_ambiguo…). Los mensajes de error nombran el sitio que falló (bomemelilla.es o melilla.es); nunca rompen la conversación con una excepción.

Los CVE tienen la forma BOME-L-AAAA-N: BOME-B-2026-6416 (boletín), BOME-BX-2026-41 (extraordinario), BOME-A-2026-1051 (artículo), BOME-S-2026-6416 (sumario), BOME-P-2026-4784 (página), BOME-PX-2021-362 (página de un extraordinario). Se aceptan en minúsculas y con espacios.

🔍 Cómo busca el sitio (y por qué importa)

Todo lo que sigue está medido contra el sitio real, no deducido de su interfaz. Condiciona cómo hay que redactar las búsquedas.

Ejemplo: «nombramientos y ceses de personal eventual»

«Personal eventual» y «cese» deben estar en el mismo artículo; para incluir también los nombramientos hace falta un O, así que la herramienta es buscar_articulos (o buscar_en_indice si el índice ya está sincronizado). Los términos forman grupos Y separados por cada "operador": "o":

{
  "texto": "personal eventual",
  "terminos": [
    {"texto": "cese"},
    {"texto": "personal eventual", "operador": "o"},
    {"texto": "nombramiento"}
  ],
  "max_bomes": 50
}

Se lee así: (personal eventual Y cese) O (personal eventual Y nombramiento). El servidor lanza una búsqueda en el sitio por cada grupo, junta los boletines sin repetir, del más reciente al más antiguo, y devuelve cada artículo con su CVE, sumario, departamento, consejería, organismo, url y pdf_url.

Solo para los ceses, sin el O, basta con:

{"texto": "personal eventual", "terminos": [{"texto": "cese"}]}

Con esta última consulta, el sitio devolvió 12 boletines el 23 de septiembre de 2026.

Para buscar dentro del texto de las páginas (la única vía para 2014–2016), usa buscar_bomes con ambito="contenido"; devuelve boletines, no artículos.

📇 Índice local de sumarios

Un fichero SQLite en tu máquina con los sumarios de todos los artículos, indexado con FTS5 y el tokenizador trigram. Responde al instante y admite Y, O y «no contiene» dentro del mismo artículo, igual que buscar_articulos, pero sin tocar el sitio.

Guarda dos orígenes: bomemelilla.es (desde 2018 por defecto) y, si lo indexas, el portal antiguo de melilla.es (1991–2017 por defecto). Cada artículo de buscar_en_indice trae su origen ("bomemelilla.es" o "melilla.es"); en los del portal antiguo, url es la ficha del boletín en melilla.es y pdf_url el PDF de la página del artículo (se lee con leer_pdf y url).

coincidencia: fragmento o palabra

En los dos modos se ignoran tildes y mayúsculas, y un * final se acepta pero no cambia nada. Los términos de menos de 3 caracteres (p. ej. "de") no caben en un índice de trigramas: se resuelven recorriendo los sumarios, y funcionan igual. Otros parámetros: desde/hasta, extraordinario, consejeria (parte del nombre, sin tildes), orden ("fecha" o "relevancia", esta última aproximada), limite (máximo 200) y desplazamiento; siguiente da el desplazamiento de la página siguiente.

Sincronizar

• Solo se sincroniza cuando el modelo llama a sincronizar_indice. El servidor nunca recorre el sitio por su cuenta, ni al arrancar.

• La herramienta vuelve al instante; la sincronización sigue en segundo plano, del boletín más reciente al más antiguo.

• Por defecto cubre desde el 1 de enero de 2018 hasta hoy. Antes de 2018 bomemelilla.es está incompleto e inestable (faltan boletines, sus páginas rotas responden HTTP 500 y de ahí vienen los bloqueos del cortafuegos) y casi no hay sumarios que buscar; esos boletines se consultan mejor en el portal antiguo de melilla.es. Puedes pedir un desde anterior, pero no es recomendable.

• Va despacio a propósito (por defecto, ~2–3 s entre peticiones) y cada ejecución indexa como mucho 250 boletines (los más recientes; parámetro max_boletines), unos 15–20 minutos (más si el sitio responde con errores; ver abajo). El rango por defecto (~1.100 boletines desde 2018) necesita varias ejecuciones: si el estado final trae pendientes_tras_limite mayor que 0, vuelve a sincronizar más tarde. Espaciar las ejecuciones es más amable con el sitio. El índice completo ocupa del orden de 40–50 MB.

• Es reanudable: cada boletín se guarda en cuanto se procesa. Si se corta, la siguiente llamada continúa donde quedó. Por defecto también reindexa los boletines de los últimos 7 días (reindexar_recientes_dias) y reintenta los que fallaron (reintentar_errores), salvo los roto.

• Sigue el progreso con estado_indice (hechos, total_planificado, eta_segundos, rotos). Mientras tanto buscar_en_indice funciona, pero avisa de que los resultados son parciales.

• cancelar_sincronizacion para tras el boletín en curso (o al instante si está en una pausa); lo ya indexado se conserva.

• Cuida el cortafuegos del sitio, que bloquea la IP tras unas 5 respuestas de error (detalle en Seguridad y cortesía). Estas cifras, como el ritmo y el límite de arriba, son los valores por defecto: puedes cambiarlas en los ajustes de ritmo y protección:

  • No pasa de 3 respuestas de error cada 10 minutos: si llega al límite, hace una pausa preventiva (la indica mensaje), así que puede ir más lenta.

  • Tras una página de boletín rota (HTTP 500) hace una pausa de 30–60 s.

  • Un boletín cuya página respondió 500 dos veces queda como roto: las sincronizaciones normales lo saltan y estado_indice lo cuenta aparte, no como pendiente. reintentar_rotos: true los vuelve a pedir, pero cada uno cuesta un 500 que el cortafuegos cuenta: úsalo solo para comprobar si el sitio los arregló.

  • Si el sitio bloquea igualmente (403, 429 o 503, o dos peticiones seguidas sin respuesta), termina en estado bloqueado y bome-navaja no vuelve a pedirle nada durante 75 minutos (o más, si el sitio lo pide con Retry-After); reintentar_tras_segundos dice cuánto falta. Relánzala pasado ese tiempo: continúa donde quedó.

• Si tienes dos clientes abiertos con bome-navaja (por ejemplo, Claude Desktop y Claude Code), solo uno sincroniza: el otro recibe en_curso_en_otro_proceso con el origen que ocupa el turno. Hay un solo turno por índice, sea cual sea el origen: mientras sincroniza bomemelilla.es no se puede sincronizar el portal antiguo, y al revés. El turno se considera abandonado si su dueño deja de dar señales durante 3 minutos.

Cada respuesta de buscar_en_indice trae un bloque cobertura (rango de fechas indexado, boletines indexados y pendientes, última sincronización, si hay una en curso, y lo indexado de cada origen en por_origen). Los pendientes cuentan solo desde 2018; los boletines anteriores que un índice de una versión previa tenga en su calendario sin indexar salen aparte en pendientes_anteriores_2018 (también en estado_indice). Si el índice está vacío, devuelve 0 resultados y un aviso que sugiere sincronizar o usar buscar_articulos mientras tanto.

Indexar el portal antiguo (melilla.es)

sincronizar_indice con origen="melilla.es" guarda en el mismo índice los sumarios de artículos del portal antiguo, para buscar con Y, O y «no contiene» en 1991–2017 y en varios años a la vez, cosa que la búsqueda del portal (literal, de una sola frase y sin paginar) no permite.

{"origen": "melilla.es"}

• Qué indexa: los sumarios de la ficha de cada boletín (ficha_bome.jsp), con una petición por boletín y nunca los PDF. Por defecto, los boletines del 1 de enero de 1991 al 31 de diciembre de 2017: antes de 1991 las fichas no traen artículos (solo el PDF del boletín entero) y desde 2018 está bomemelilla.es. Admite otro desde/hasta.

• El mismo ritmo y el mismo límite que la de bomemelilla.es: por defecto, 2 s más hasta 1 s aleatorio entre peticiones y como mucho 250 boletines por ejecución (max_boletines), unos 15–20 minutos. El rango por defecto tiene unos 2.000–2.500 boletines, así que hacen falta unas 8–10 ejecuciones, mejor espaciadas; pendientes_tras_limite dice cuántos quedan. Los ajustes de ritmo y protección (BOME_NAVAJA_SYNC_DELAY, BOME_NAVAJA_SYNC_MAX_BOLETINES y el resto) son los mismos para los dos orígenes.

• Es reanudable y no repite trabajo: se salta los boletines ya indexados con sumarios (de cualquier origen) y los que el portal ya dio sin artículos. Reintenta los fallidos (reintentar_errores) y los roto solo con reintentar_rotos. reindexar_recientes_dias no se aplica: el portal está congelado.

• Usa la guardia del portal antiguo (estado_sitio_melilla.json), no la de bomemelilla.es: termina bloqueado si melilla.es la bloquea, y sus errores no cuentan para el otro sitio.

• Un solo turno por índice: mientras corre la sincronización de un origen, la del otro recibe en_curso_en_otro_proceso. cancelar_sincronizacion para la que esté en curso, sea del origen que sea.

• Si un boletín está en los dos orígenes, gana el mejor resultado: con sumarios gana a sin sumarios, y este a un fallo; a igualdad, gana bomemelilla.es. Así los boletines de 2014–2016, que bomemelilla.es tiene sin sumarios, se rellenan con los del portal antiguo, y cada boletín sale una sola vez en buscar_en_indice.

• Resultados: cada artículo trae origen: "melilla.es", url (la ficha del boletín en melilla.es) y pdf_url (el PDF de la página del artículo, para leer_pdf con url). Su bome_cve es el identificador del portal (antes de 2014 no es un CVE de bomemelilla.es; si se repite, lleva el dboid detrás, como BOME-BX-1986-1~280058) y su cve, una clave interna MEL-<dboid>-<número>. estado_indice cuenta cada origen en por_origen, guarda la última sincronización de cada uno en ultimas_sincronizaciones y muestra el origen de la que está en curso.

Dónde está y cómo rehacerlo

El índice es el fichero sumarios.sqlite3 dentro de la carpeta de datos; estado_servidor y estado_indice muestran su ruta. Para rehacerlo desde cero, cierra el cliente, borra sumarios.sqlite3 (y sumarios.sqlite3-wal / sumarios.sqlite3-shm si existen) y vuelve a llamar a sincronizar_indice. Un índice de una versión anterior de bome-navaja se migra solo al abrirlo, sin volver a descargar nada; los boletines que tenían anotado un HTTP 500 pasan a roto.

🏛️ Portal antiguo (melilla.es)

bomemelilla.es es una migración incompleta antes de 2018: de 2014 a 2017 le faltan 141 boletines (y ahí se concentran sus páginas rotas), y no tiene nada anterior a 2014. El portal antiguo del BOME en melilla.es, congelado desde marzo de 2021, conserva el catálogo entero: 3.260 boletines del 3 de enero de 1985 al 12 de marzo de 2021, con sumarios de artículos desde ~1991 y el PDF de cada página.

Si ver_bome no encuentra un boletín anterior a 2022 en bomemelilla.es, su error sugiere ver_bome_antiguo.

Identificadores. Desde 2014 la numeración del portal antiguo coincide con los CVE de bomemelilla.es (BOME-B-2016-5302, BOME-BX-2021-16). Antes de 2014 los identificadores tienen la misma forma pero no son CVE de bomemelilla.es (cve_oficial: false) y algunos se repiten (24 casos, por ejemplo dos «Extra 1» en 1986): ver_bome_antiguo responde entonces boletin_ambiguo con los candidatos (dboid, fecha, sufijo), y basta con repetir con el dboid. Además, 14 boletines tienen una fecha distinta en cada sitio (por ejemplo BOME-B-2015-5230: 17-12-2015 en bomemelilla.es y 01-05-2015 en melilla.es); cita la fecha junto al origen.

robots.txt y política de uso. El robots.txt de melilla.es no permite a los robots las fichas de boletín (ficha_bome.jsp) ni los PDF (/mandar.php). Las herramientas solo los piden bajo demanda: cuando el modelo llama a una para responderte, una petición cada vez. Desde la versión 0.0.4 hay una excepción deliberada, porque el portal está congelado y puede desaparecer: la indexación del portal antiguo recorre las fichas en masa, pero solo cuando se pide con sincronizar_indice y origen="melilla.es" (nunca por su cuenta), despacio (por defecto, ~2–3 s entre peticiones), con un máximo de 250 boletines por ejecución (también por defecto) y bajo la guardia del portal. Los PDF nunca se recorren en masa: solo se piden bajo demanda.

Su propia guardia y su caché. El portal antiguo es otro sitio, así que tiene su propia guardia con las mismas reglas y los mismos ajustes (por defecto, como mucho 3 respuestas de error cada 10 minutos y 75 minutos sin pedirle nada si bloquea), guardada aparte en estado_sitio_melilla.json; sus errores nunca cuentan para bomemelilla.es, y estado_servidor la muestra en guardia_portal_antiguo. Sus herramientas van a su propio ritmo (~1–1,5 s entre peticiones, de una en una), que no se puede ajustar. El catálogo (~1 MB) se descarga con una sola petición la primera vez que hace falta y se guarda en catalogo_portal_antiguo.json; como el portal está congelado, se reutiliza siempre (estado_servidor lo muestra en catalogo_portal_antiguo; borrarlo fuerza una nueva descarga). Si el portal no responde, listar_bomes devuelve igualmente lo de bomemelilla.es con un aviso.

📖 Leer documentos largos

leer_articulo, leer_boletin y leer_pdf comparten el mismo cursor, así que un boletín de ~35 páginas nunca llega recortado en silencio:

Para seguir leyendo, pasa desde_pagina y desde_caracter tal cual vienen en siguiente.

leer_articulo acepta el CVE del artículo (BOME-A-2026-1051) o el del boletín más numero. Para los artículos de 2014–2016, que no tienen texto, responde con fuente: "ninguna" y un aviso.

💾 PDF descargados

• descargar_pdf (y los lectores cuando hace falta) guardan cada PDF en la carpeta de PDF, por defecto pdfs/ dentro de la carpeta de datos.

• El nombre del fichero es siempre el CVE canónico (BOME-P-2026-4784.pdf) o, para un PDF del portal antiguo, la ruta de su URL ya validada (https://www.melilla.es/mandar.php/n/9/4914/5302_73.pdf → melilla-9-4914-5302_73.pdf): nunca sale de datos del servidor ni de lo que escriba el modelo, y no hay parámetro para elegir otra ruta. Solo tú puedes moverla, con BOME_NAVAJA_PDF_DIR.

• Del portal antiguo solo se aceptan URL https://www.melilla.es/mandar.php/n/<número>/<número>/<nombre>.pdf (sus enlaces http:// se pasan a https); cualquier otra se rechaza con url_pdf_invalida sin tocar la red.

• Una copia válida en caché se reutiliza; refrescar: true fuerza la descarga. La escritura es atómica, y una descarga fallida conserva la copia anterior.

• Límite: 100 MB por PDF (documento_demasiado_grande). Como referencia, un boletín ordinario ronda los 4 MB.

📂 Dónde guarda los datos

Dentro están el índice (sumarios.sqlite3), los PDF (pdfs/), el estado de la guardia del sitio (estado_sitio.json, y estado_sitio_melilla.json para el portal antiguo) y la caché del catálogo del portal antiguo (catalogo_portal_antiguo.json). Nada se crea hasta que hace falta.

Una ruta relativa en estas variables se resuelve contra el directorio de trabajo del proceso, y estado_servidor lo indica en el motivo de cada ruta; ~ se expande a tu carpeta de usuario. Un XDG_DATA_HOME relativo se ignora, como manda la especificación XDG. Con el paquete .mcpb, el ajuste Carpeta de datos fija BOME_NAVAJA_DATA_DIR; vacío equivale a no definirla.

🚀 Instalación

Hay tres caminos, de menos a más técnico. Todos necesitan uv salvo el paquete .mcpb, que Claude Desktop gestiona solo.

Opción A — Paquete .mcpb para Claude Desktop

1. Consigue el paquete. Descarga bome-navaja-<versión>.mcpb desde la sección Releases del repositorio (la primera es v0.0.1). Otras opciones:

   • El artefacto bome-navaja-mcpb de una ejecución en verde del flujo CI (pestaña Actions del repositorio), para probar una versión sin publicar.

   • O constrúyelo desde un clon (necesitas uv y Node.js con npx): scripts/build_mcpb.sh en macOS/Linux o scripts\build_mcpb.ps1 en Windows PowerShell. El resultado queda en dist/bome-navaja-<versión>.mcpb (unos 70 KB).

2. Haz doble clic en el archivo, o arrástralo a la ventana de Claude Desktop. Aparece el diálogo de instalación con las 19 herramientas.

3. Opcional: en Carpeta de datos elige dónde guardar el índice y los PDF. Si la dejas vacía se usa la carpeta por defecto de tu sistema. Los demás ajustes (el ritmo con que se piden páginas y la protección frente al bloqueo del sitio) ya traen los valores recomendados: no los hagas más agresivos sin leer antes Ajustes de ritmo y protección.

4. Acepta y reinicia Claude por completo si te lo pide.

La primera vez que arranca, Claude Desktop instala Python y las dependencias por su cuenta (unos segundos). Desde la versión 0.0.5 el paquete incluye uv.lock, así que instala las mismas versiones de las dependencias con las que se probó esa versión.

Requisito: uv

Para las opciones B y C, bome-navaja no necesita que instales Python: uv lo baja solo, junto con las dependencias, la primera vez. Instálalo una vez:

# macOS y Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Cierra y vuelve a abrir la terminal después de instalarlo.

Opción B — Claude Code

claude mcp add bome-navaja -- uvx --from git+https://github.com/jgarcialaneitor/bome-navaja bome-navaja-mcp

Opción C — Configuración manual de Claude Desktop

1. En Claude Desktop, ve a Settings → Developer → Edit Config para abrir claude_desktop_config.json:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añade la entrada dentro de mcpServers:

{
  "mcpServers": {
    "bome-navaja": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jgarcialaneitor/bome-navaja",
        "bome-navaja-mcp"
      ]
    }
  }
}

O, desde un clon local (por ejemplo, si no tienes acceso git al repositorio privado):

{
  "mcpServers": {
    "bome-navaja": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ruta/a/tu/clon/bome-navaja",
        "bome-navaja-mcp"
      ],
      "env": {
        "BOME_NAVAJA_DATA_DIR": "/ruta/opcional/para/los/datos"
      }
    }
  }
}

La clave env es opcional; en ella también van los ajustes de ritmo y protección.

3. Guarda y cierra Claude por completo (no solo la ventana). Al reabrirlo deben aparecer las herramientas de bome-navaja.

Comprobar que quedó bien

Pídele al asistente:

Ejecuta estado_servidor de bome-navaja.

Debe responder con la versión, las rutas de datos, PDF e índice (y por qué se eligió cada una), si SQLite tiene FTS5 y trigram, y los ajustes en uso con sus avisos (ajustes). No toca la red ni crea el índice. Luego prueba una búsqueda real:

Busca en el BOME los artículos sobre ceses de personal eventual y cita sus CVE.

🔒 Seguridad y cortesía con el sitio

Las cifras de esta sección son los valores por defecto, que son también los recomendados; cómo cambiarlas y qué arriesgas al hacerlo está en Ajustes de ritmo y protección.

• Pausa de cortesía entre peticiones en las herramientas (~0,5 s por defecto), con tiempos de espera acotados (30 s por defecto).

• Un único cliente serializado para todas las herramientas: aunque el modelo lance varias a la vez, las peticiones al sitio salen de una en una.

• La sincronización del índice va más despacio: por defecto, su propio cliente espera 2 s más una variación aleatoria de hasta 1 s entre peticiones, indexa como mucho 250 boletines por ejecución y se detiene sola (estado bloqueado) si el sitio la bloquea. La del portal antiguo va igual.

• Guardia del sitio. El cortafuegos de bomemelilla.es bloquea la IP (en torno a una hora) tras unas 5 respuestas de error, por despacio que vayan las peticiones, y muchas son HTTP 500 de páginas de boletín rotas del propio sitio. Para no llegar a eso:

  • Entre todas las herramientas y la sincronización se admiten como mucho 3 respuestas de error (cualquier 4xx o 5xx) cada 10 minutos (valores por defecto); con el cupo lleno, la sincronización espera y las herramientas responden pausa_preventiva con reintentar_tras_segundos, sin tocar el sitio.

  • La sincronización hace una pausa de 30–60 s (por defecto) tras una página rota y no vuelve a pedir un boletín roto (su página respondió 500 dos veces) salvo con reintentar_rotos.

  • Si el sitio bloquea igualmente (403, 429 o 503, o dos peticiones seguidas sin respuesta), bome-navaja deja de tocarlo durante 75 minutos por defecto (o más, si pide Retry-After): las herramientas responden sitio_bloqueando con reintentar_tras_segundos y la sincronización termina bloqueado.

  Todos los procesos de bome-navaja comparten esta guardia y se conserva entre reinicios: vive en estado_sitio.json, en la carpeta de datos. estado_servidor la muestra en guardia_sitio. El portal antiguo de melilla.es tiene otra guardia igual pero aparte (estado_sitio_melilla.json, guardia_portal_antiguo).

• Portal antiguo: sus PDF (que su robots.txt no permite a los robots) se piden solo bajo demanda, cuando una herramienta los necesita para responderte, nunca en masa. Sus fichas (que tampoco permite) solo se recorren en masa con la indexación del portal antiguo, que arranca solo a mano, va despacio y tiene límite por ejecución; ver Portal antiguo.

• No recorre el sitio si no se le pide: nada al arrancar, y la sincronización solo con sincronizar_indice. Nunca corren dos sincronizaciones a la vez sobre el mismo índice, ni de dos procesos ni de dos orígenes.

• Se identifica con un User-Agent de navegador real y no usa ni guarda credenciales.

• El modelo no elige dónde se escribe: los PDF se nombran por su CVE canónico dentro de la carpeta configurada, y las rutas solo las cambias tú con variables de entorno.

• stdout lleva exclusivamente JSON-RPC; los mensajes para personas van a stderr.

Ajustes de ritmo y protección

Los nueve ajustes son los mismos para bomemelilla.es y para el portal antiguo de melilla.es (cada sitio con su propia guardia). Los cambios se aplican al reiniciar la extensión (o el servidor MCP en otros clientes): el servidor los lee una sola vez por proceso.

• Con el paquete .mcpb: en Claude Desktop, abre la configuración de la extensión BOME Melilla — Boletín Oficial de Melilla. Cada ajuste aparece con el nombre de la tabla y una descripción con lo que hace, lo que arriesgas y el valor recomendado.

• Con otros clientes (Claude Code, la configuración manual…): define las variables de entorno de la tabla en la configuración del servidor, por ejemplo en la clave env:

"env": {
  "BOME_NAVAJA_SYNC_DELAY": "3",
  "BOME_NAVAJA_SYNC_MAX_BOLETINES": "100"
}

Una variable vacía o sin definir usa el valor por defecto. Los decimales admiten punto o coma (0.5 o 0,5), y los recuentos, un entero escrito como 250.0. Un tiempo de más de un día (24 horas) no es válido: se usa el valor por defecto. estado_servidor muestra los valores en uso en ajustes (y el ritmo de la sincronización en cortesia_sincronizacion y cortesia_sincronizacion_portal_antiguo).

🧪 Desarrollo

uv sync
uv run pytest                          # determinista, contra respuestas guardadas del sitio
BOME_NAVAJA_LIVE=1 uv run pytest       # además, los tests marcados live contra el sitio real

Los tests live consultan bomemelilla.es y se omiten salvo que definas BOME_NAVAJA_LIVE=1; la CI nunca los ejecuta.

Para construir el paquete .mcpb: scripts/build_mcpb.sh (macOS/Linux) o scripts\build_mcpb.ps1 (Windows). Ambos preparan build/mcpb con scripts/build_mcpb.py, validan el manifiesto con npx @anthropic-ai/mcpb validate y empaquetan en dist/. El manifiesto parte de mcpb/manifest.template.json.

La CI (.github/workflows/ci.yml) tiene cuatro trabajos:

🚧 Limitaciones conocidas

• El O del sitio no funciona: su buscador trata el O como Y. buscar_bomes lo rechaza; el O solo funciona en buscar_articulos y buscar_en_indice.

• Artículos ocultos en los extremos: los artículos que la página del boletín omite se recuperan cuando dejan un hueco en la numeración, pero no se detectan si faltan al principio o al final del boletín.

• 2014–2016 sin texto ni PDF: solo se puede buscar en el contenido con buscar_bomes y ambito="contenido".

• El índice solo cubre sumarios, no el texto completo de los artículos ni de los PDF. Del portal antiguo solo tiene lo que hayas indexado con sincronizar_indice y origen="melilla.es" (1991–2017 por defecto, en varias ejecuciones); los boletines anteriores a ~1991 no tienen sumarios en el portal.

• Portal antiguo: su búsqueda es literal y sin paginar (una búsqueda muy genérica puede superar el límite de 15 MB y pide términos más concretos); los identificadores anteriores a 2014 no son CVE de bomemelilla.es y algunos se repiten; 14 boletines tienen una fecha distinta en cada sitio.

• Claves mixtas: algunas respuestas (ver_bome, ver_sumario, listar_bomes) usan claves en inglés (number, date, sections) junto a las castellanas del resto.

• Política de privacidad: el sitio no publica un aviso legal, así que el enlace de privacidad del paquete .mcpb apunta a su política de cookies.

📜 Licencia

MIT. Consulta LICENSE.