Skeleton UI MCP Server

This project was built with the assistance of coding agents (Claude Code).

[!WARNING] Svelte only. This MCP server currently covers the Svelte version of Skeleton UI exclusively. React and other framework variants are not included yet.

An MCP server that exposes the Skeleton UI documentation as tools for coding agents. Documentation is served from pre-fetched static files — no live network calls during tool use.

Tools

Claude Desktop Configuration

Using uvx (recommended)

No installation needed — uvx fetches and runs the package automatically:

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

From source

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"
      ]
    }
  }
}

Refreshing the Static Files

The skeleton_ui_mcp_server/static/ directory contains pre-fetched documentation from skeleton.dev. To refresh it manually:

uv run --extra fetch python index.py

This re-fetches all pages listed in skeleton_ui_mcp_server/static/_llms.txt and regenerates the individual JSON files.

A GitHub Actions workflow (.github/workflows/update-static.yml) runs this automatically every night at 03:00 UTC and commits any changes back to the repository. It can also be triggered manually via Actions → Update static docs → Run workflow. The integrity tests (tests/test_audit.py) run as part of the workflow before committing — if they fail the commit is skipped.

Quality Assurance

Install dev dependencies first:

uv sync --group dev