Skeleton UI Docs

Un servidor MCP que expone la documentación de Skeleton UI como herramientas para agentes de codificación.

Documentación

Servidor MCP de Skeleton UI

Este proyecto fue construido con la asistencia de agentes de codificación (Claude Code).

[!WARNING] Solo Svelte. Este servidor MCP actualmente cubre exclusivamente la versión Svelte de Skeleton UI. Las variantes de React y otros frameworks aún no están incluidas.

Un servidor MCP que expone la documentación de Skeleton UI como herramientas para agentes de codificación. La documentación se sirve desde archivos estáticos precargados — sin llamadas de red en vivo durante el uso de las herramientas.

Herramientas

Herramienta	Descripción
`search_docs(query, limit?)`	Búsqueda de palabras clave en títulos, slugs, extractos y grupos. Úsala primero para encontrar el slug correcto.
`list_docs_by_group(group)`	Lista todos los documentos en una categoría (p. ej. `"Framework Components"`).
`list_all_docs()`	Índice completo de los 58 documentos. Prefiere las herramientas anteriores.
`get_docs_for(slug)`	Devuelve la documentación Markdown completa para un slug.
`list_themes()`	Lista todos los temas preestablecidos disponibles de Skeleton UI.
`get_theme_info(theme)`	Obtén tokens de diseño detallados (colores, fuentes, etc.) para un tema específico.
`get_theme_guide()`	Obtén orientación sobre la configuración de temas y la ubicación de temas personalizados.

Configuración de Claude Desktop

Usando uvx (recomendado)

No se necesita instalación — uvx obtiene y ejecuta el paquete automáticamente:

{
  "mcpServers": {
    "skeleton-ui-docs": {
      "command": "uvx",
      "args": ["skeleton-ui-mcp-server@latest"]
    }
  }
}

Desde el código fuente

git clone <repo>
cd skeleton-ui-mcp-server
uv sync

{
  "mcpServers": {
    "skeleton-ui-docs": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/skeleton-ui-mcp-server",
        "run",
        "skeleton-ui-mcp-server"
      ]
    }
  }
}

Actualización de los Archivos Estáticos

El directorio skeleton_ui_mcp_server/static/ contiene documentación precargada desde skeleton.dev. Para actualizarlo manualmente:

uv run --extra fetch python index.py

Esto vuelve a obtener todas las páginas listadas en skeleton_ui_mcp_server/static/_llms.txt y regenera los archivos JSON individuales.

Un flujo de trabajo de GitHub Actions (.github/workflows/update-static.yml) ejecuta esto automáticamente cada noche a las 03:00 UTC y confirma cualquier cambio de vuelta al repositorio. También se puede activar manualmente mediante Actions → Update static docs → Run workflow. Las pruebas de integridad (tests/test_audit.py) se ejecutan como parte del flujo de trabajo antes de confirmar — si fallan, la confirmación se omite.

Garantía de Calidad

Instala primero las dependencias de desarrollo:

uv sync --group dev

Comando	Qué hace
`uv run --group dev pytest -v`	Ejecuta todas las pruebas (pruebas de humo de herramientas + integridad estática)
`uv run --group dev pytest tests/test_tools.py -v`	Solo pruebas de herramientas MCP
`uv run --group dev pytest tests/test_audit.py -v`	Solo pruebas de datos estáticos + formato `_llms.txt`
`uv run --group dev pyright`	Verificación de tipos de `server.py` y `index.py`
`uv run --group dev pip-audit`	Escanea dependencias en busca de vulnerabilidades conocidas