Skip to content
MCP-BOE GitHub Details, Stars and Alternatives | OpenRepoFinder
Home / Repositories / ComputingVictor/MCP-BOE ComputingVictor / repository
MCP-BOE MCP server para el BOE 🇪🇸 — Acceso a legislación consolidada, sumarios diarios y tablas oficiales del Boletín Oficial del Estado mediante Model Context Protocol y API REST.
#api #boe #government #legal #mcp #model-context-protocol
View Repository on GitHub ↗ REPOSITORY OVERVIEW Live repository statistics ★ 45 Stars
⑂ 12 Forks
◯ 1 Open issues
◉ 45 Watchers
77 /100
OPENREPOHUB HEALTH SIGNAL Healthy signals A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
100 Community adoption25% weight
32 Maintenance state20% weight
85 License clarity10% weight
100 Project information10% weight
75 This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview MCP BOE 🇪🇸
Model Context Protocol para el Boletín Oficial del Estado español
Un servidor MCP que permite a Claude y otros LLMs acceder a la API oficial del BOE para consultar legislación consolidada, sumarios diarios y tablas auxiliares del gobierno español.
🚀 Características
🔍 Búsqueda de Legislación : Buscar en más de 50.000 normas consolidadas con filtros por departamento, rango normativo, materia y fechas📰 Sumarios del BOE/BORME : Acceder a publicaciones diarias, búsquedas recientes y resúmenes semanales🏛️ Tablas Auxiliares : Consultar códigos de departamentos, materias, rangos normativos y ámbitos📄 Lectura de PDFs : Descargar y extraer el texto de cualquier documento del BOE para analizarlo💬 Prompts integrados : Plantillas de consulta listas para usar en Claude📊 Datos Oficiales : Conecta directamente con la API oficial del BOE⚙️ Configurable : Timeout, reintentos y nivel de log via variables de entorno
📋 Tabla de Contenidos
🛠️ Instalación
Prerrequisitos
Python 3.10 o superior (requerido por la librería mcp)
uv (recomendado) o pip
Opción 1: uvx — sin instalación (Recomendado) Con uvx no necesitas clonar el repositorio ni gestionar dependencias:
uvx --from git+https://github.com/ComputingVictor/MCP-BOE.git mcp-boe
Opción 2: Desde el código fuente con uv git clone https://github.com/ComputingVictor/MCP-BOE.git
cd MCP-BOE
# Instalar dependencias y ejecutar
uv run python -m mcp_boe.server
Opción 3: Instalación con pip git clone https://github.com/ComputingVictor/MCP-BOE.git
cd MCP-BOE
pip install -e .
🖥️ Configuración con Claude Desktop Edita el archivo de configuración de Claude Desktop:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows : %APPDATA%\Claude\claude_desktop_config.json
Con uv (Recomendado) {
"mcpServers": {
"mcp-boe": {
"command": "uv",
"args": [
"run",
"--python", "3.12",
"--project", "/ruta/absoluta/a/MCP-BOE",
"python", "-m", "mcp_boe.server"
]
}
}
}
Sustituye /ruta/absoluta/a/MCP-BOE por la ruta real donde clonaste el repositorio.
Con uvx {
"mcpServers": {
"mcp-boe": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ComputingVictor/MCP-BOE.git", "mcp-boe"]
}
}
}
Reinicia Claude Desktop tras guardar los cambios.
⚡ Configuración con Claude Code
Con uvx {
"mcpServers": {
"mcp-boe": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ComputingVictor/MCP-BOE.git", "mcp-boe"],
"transport": "stdio"
}
}
}
También puedes usar el archivo incluido en el repositorio:
# Desde el directorio del proyecto
claude --mcp-config claude_mcp_config_uvx.json
💬 Prompts disponibles El servidor incluye 4 prompts integrados accesibles desde el selector de prompts de Claude:
buscar_legislacionBusca y resume normas del BOE.
Argumento Descripción Requerido temaTexto o nombre de la norma a buscar ✅ departamentoMinisterio u organismo emisor ❌
tema: protección de datos → encuentra RGPD y LOPDGDD
tema: Ley 40/2015 → Ley de Régimen Jurídico del Sector Público
tema: tráfico, departamento: Ministerio del Interior
analizar_normaAnálisis completo de una norma: metadatos, estado de vigencia, estructura y relaciones con otras normas.
Argumento Descripción Requerido id_normaIdentificador BOE (ej: BOE-A-2015-10566) ✅
BOE-A-1978-31229 → Constitución EspañolaBOE-A-2015-10566 → Ley 40/2015 de Régimen Jurídico del Sector PúblicoBOE-A-2018-16673 → Ley Orgánica de Protección de Datos
resumen_boe_diaResumen de las publicaciones más relevantes del BOE de una fecha concreta.
Argumento Descripción Requerido fechaFecha en formato AAAAMMDD ✅ seccionSección del BOE: 1, 2A, 2B, 3, 4, 5 ❌
fecha: 20250101 → publicaciones del 1 de enero de 2025
fecha: 20240529, seccion: 1 → solo disposiciones generales
comparar_normasCompara dos normas e identifica relaciones de modificación o derogación entre ellas.
Argumento Descripción Requerido id_norma_1Identificador de la primera norma ✅ id_norma_2Identificador de la segunda norma ✅
BOE-A-2015-10566 y BOE-A-2015-10565 → Ley 40/2015 y Ley 39/2015 (las dos grandes leyes administrativas)
🔧 Herramientas disponibles 31 herramientas en total organizadas en 5 grupos.
📜 Legislación Consolidada (9 herramientas) Herramienta Descripción Parámetros clave search_consolidated_legislationBusca en más de 50.000 normas consolidadas query, title, department_code, legal_range_code, matter_code, from_date, to_date, limit, include_derogatedget_consolidated_lawObtiene metadatos, análisis jurídico y texto de una norma law_id, include_metadata, include_analysis, include_full_text, include_eli_metadataget_law_structureÍndice completo de una norma (artículos, disposiciones, anexos) law_idget_law_text_blockTexto de un artículo o disposición específica law_id, block_idfind_related_lawsNormas que modifican, derogan o son modificadas por una norma law_id, relation_typecompare_law_versionsCompara el texto de una norma entre dos fechas, detectando artículos añadidos, modificados o eliminados law_id, from_date, to_date, granularitysearch_law_articlesBusca artículos concretos dentro de una norma sin descargar el texto completo law_id, query, search_in, limitget_law_metadataObtiene solo los metadatos de una norma (rango, fecha, órgano, estado, enlaces) sin cargar el texto law_idlist_related_lawsLista normas relacionadas con control granular sobre qué tipos de relación incluir law_id, include_derogating, include_development, include_references
📰 Sumarios BOE/BORME (7 herramientas) Herramienta Descripción Parámetros clave get_boe_summarySumario completo del BOE para una fecha date, section_filter, department_filter, max_itemsget_borme_summarySumario del BORME (Registro Mercantil) date, province_filter, max_itemssearch_recent_boeBusca documentos en los últimos N días days_back, search_terms, section_filterget_weekly_summaryEstadísticas y resumen de una semana completa start_date, include_statisticsget_boe_summary_rangeAgrega los sumarios de un rango de fechas (máx. 31 días) con filtro de sección from_date, to_date, section, max_itemswatch_boe_changesRadar normativo: busca publicaciones recientes por palabras clave days_back, keywords, sections, max_itemsgroup_summary_by_departmentAgrupa las publicaciones de un rango de fechas por departamento emisor from_date, to_date, sections, max_items_per_dept
🏛️ Tablas Auxiliares (10 herramientas) Herramienta Descripción get_departments_tableLista de departamentos oficiales con sus códigos get_legal_ranges_tableRangos normativos (Ley, Real Decreto, Orden, etc.) get_matters_tableVocabulario controlado de materias temáticas get_scopes_tableÁmbitos normativos (estatal, autonómico) get_consolidation_states_tableEstados de consolidación search_auxiliary_dataBúsqueda en todas las tablas a la vez get_code_descriptionDescripción de un código específico search_departments_advancedBúsqueda avanzada de departamentos con filtro por código padre (jerarquía) list_topics_for_lawLista las materias del vocabulario controlado de una norma concreta suggest_auxiliary_filtersDado un texto libre, sugiere códigos de departamento, rango y materia para filtrar búsquedas
🛠️ Calidad de vida para LLMs (4 herramientas) Herramienta Descripción Parámetros clave summarize_law_sectionsResumen estructurado de una norma con el primer párrafo de cada artículo law_idpaginate_law_textDevuelve el texto de una norma por páginas usando un cursor opaco law_id, cursor, max_charsexplain_law_structureDescribe la estructura jerárquica de una norma con recuento de elementos por nivel law_idnormalize_boe_referenceNormaliza una referencia textual a una norma o sumario en campos estructurados reference_text
📄 Lectura de PDFs (1 herramienta) Herramienta Descripción Parámetros clave read_boe_pdfDescarga y extrae el texto de un PDF del BOE source, max_pages
source
URL directa : la que aparece en el campo url_pdf de los sumarioshttps://www.boe.es/boe/dias/2025/03/28/pdfs/BOE-A-2025-6192.pdfIdentificador BOE : el servidor consulta la API para obtener la fecha y construye la URLBOE-A-2025-6192 o BOE-A-2015-10566 max_pages30, máximo 100).
Límites aplicados: PDFs de hasta 10 MB y 80.000 caracteres de texto devuelto al LLM.
Ejemplos de uso en Claude:
Lee el PDF de BOE-A-2015-10566 y explícame qué regula la Ley 40/2015
Descarga https://www.boe.es/boe/dias/2025/03/28/pdfs/BOE-A-2025-6192.pdf y resume su contenido
Busca el sumario del BOE de hoy y léeme el PDF del primer real decreto que aparezca
📌 Formatos y valores útiles Código Descripción 1Disposiciones generales 2AAutoridades y personal — Nombramientos 2BAutoridades y personal — Oposiciones 3Otras disposiciones 4Administración de Justicia 5Anuncios
Departamentos frecuentes:
Código Departamento 7723Jefatura del Estado 1430Ministerio de Justicia 1470Ministerio del Interior
Rangos normativos frecuentes:
Código Rango 1300Ley 1250Ley Orgánica 1200Real Decreto 1100Real Decreto-ley 800Orden ministerial
⚙️ Variables de entorno Variable Descripción Valor por defecto BOE_HTTP_TIMEOUT
