Skip to main content

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

Metadata

Release files for skeleton-ui-mcp-server 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for skeleton-ui-mcp-server 0.1.4
File Size Uploaded Provenance
skeleton_ui_mcp_server-0.1.4.tar.gz 302.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for skeleton-ui-mcp-server 0.1.4
File Interpreter ABI Platform
skeleton_ui_mcp_server-0.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 596.9 kB

Release files / skeleton_ui_mcp_server-0.1.4.tar.gz

Download URL skeleton_ui_mcp_server-0.1.4.tar.gz
Size 302.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4f712a10c8a7353ac41405ac039b62b43fff7694fec232c1ef59371b228a47fd
BLAKE2b-256 checksum
How to use checksums
182f91985096b2a10581bb1506c83f33e6d17929389a7eebe903aa593c6cdabf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / skeleton_ui_mcp_server-0.1.4-py3-none-any.whl

Download URL skeleton_ui_mcp_server-0.1.4-py3-none-any.whl
Size 294.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3439d116f5270e23dd2d929ad87ac0481fff54ab0f284f16af711042a63bc67a
BLAKE2b-256 checksum
How to use checksums
ab3afaa8bdf338aacaebda663be17ea4fe17a2189a123f42cc130fe89a2d35d1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.11.6 {"installer":{"name":"uv","version":"0.11.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for skeleton-ui-mcp-server 0.1.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page