MCP-BOE

MCP-BOE is a Model Context Protocol server that exposes the Spanish Boletín Oficial del Estado (BOE) data to Claude, other LLMs, and MCP clients. It provides access to consolidated legislation search, daily BOE summaries, and auxiliary code tables (departments, subjects, and normative ranges). The server also offers a REST API for programmatic access and can be operated directly via the provided tools to perform lookups, fetch summaries, and navigate the BOE data sources. To use it with Claude, you typically configure an MCP connection, pointing Claude to the mcp-boe server, and then issue requests through Claude’s MCP interface to leverage the BOE data in your prompts or workflows. The included examples show how to run searches, retrieve summaries, and query auxiliary data like departments.

Prerequisites:

• Python 3.8 or higher
• pip (Python package manager)

Install from source or via uvx (recommended for quick start):

Prerrequisitos

• Python 3.8+
• pip

Instalación rápida con uvx (Recomendado)

Si tienes uvx instalado, usa el servidor MCP directamente sin instalar manualmente:

# Verificar que uvx está instalado
uvx --version

# Ejecutar directamente desde el repositorio
uvx --from git+https://github.com/ComputingVictor/MCP-BOE.git mcp-boe --help

Instalación desde el código fuente

# Clonar el repositorio
git clone https://github.com/ComputingVictor/MCP-BOE.git
cd MCP-BOE

# Instalar dependencias básicas
pip install -e .

# O instalar con API REST
pip install -e ".[api]"

# O instalar todo para desarrollo
pip install -e ".[dev]"

Verificar instalación

# Prueba rápida de conectividad
python examples/basic_usage.py connectivity

# Prueba completa de funcionalidades
python examples/basic_usage.py quick

Configurar Claude (opcional)

Configura Claude para usar MCP-BOE con una de las opciones descritas en la sección Configuración:

• Usando uvx (recomendado para simplicidad):

# Ejemplo de configuración en Claude (uvx)

• Configuración MCP tradicional (python):

{
  "mcpServers": {
    "mcp-boe": {
      "command": "/ruta/a/tu/conda/envs/tu_env/bin/python",
      "args": ["-m", "mcp_boe.server"],
      "transport": "stdio",
      "env": {
        "PYTHONPATH": "/ruta/a/tu/MCP-BOE/src"
      }
    }
  }
}

Usar la API REST (opcional)

# Iniciar el servidor API
python rest_api_wrapper.py

La API estará disponible en: http://localhost:8000 y la documentación en http://localhost:8000/docs

Consejos y notas útiles:

• Si planeas ejecutar Claude u otros clientes MCP, asegúrate de que PYTHONPATH apunte al directorio src del repositorio MCP-BOE para que los módulos internos se carguen correctamente.
• Si prefieres usar uvx, aprovecha su manejo automático de entornos para evitar conflictos de dependencias.
• Endpoints REST disponibles: /search/legislation, /summary/boe, /auxiliary/departments, y /auxiliary/code/{code_id}; consulta la documentación integrada para más detalles.
• Para depuración, prueba primero la conectividad con el ejemplo básico y luego ejecuta operaciones más complejas como búsquedas de legislación o consultas de departamentos.
• Si actualizas el repositorio, reconstruye o reinstala con pip install -e . para garantizar que los cambios estén disponibles.
• Si utilizas Claude Code, recuerda las rutas de configuración de MCP y los permisos de lectura de archivos para configuraciones personalizadas.