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

Tool	Description
search_docs(query, limit?)	Keyword search across titles, slugs, excerpts, and groups. Use this first to find the right slug.
list_docs_by_group(group)	List all docs in a category (e.g. "Framework Components").
list_all_docs()	Full index of all 58 docs. Prefer the tools above.
get_docs_for(slug)	Returns full Markdown documentation for a slug.
list_themes()	List all available Skeleton UI preset themes.
get_theme_info(theme)	Get detailed design tokens (colors, fonts, etc.) for a specific theme.
get_theme_guide()	Get guidance on theme configuration and custom theme placement.

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

Command	What it does
uv run --group dev pytest -v	Run all tests (tool smoke tests + static integrity)
uv run --group dev pytest tests/test_tools.py -v	MCP tool tests only
uv run --group dev pytest tests/test_audit.py -v	Static data + _llms.txt format tests only
uv run --group dev pyright	Type-check server.py and index.py
uv run --group dev pip-audit	Scan dependencies for known vulnerabilities