Skeleton UI Docs

Um servidor MCP que expõe a documentação do Skeleton UI como ferramentas para agentes de codificação.

Documentação

Skeleton UI MCP Server

Este projeto foi construído com a assistência de agentes de codificação (Claude Code).

[!WARNING] Apenas Svelte. Este servidor MCP atualmente cobre exclusivamente a versão Svelte do Skeleton UI. React e outras variantes de frameworks ainda não estão incluídas.

Um servidor MCP que expõe a documentação do Skeleton UI como ferramentas para agentes de codificação. A documentação é servida a partir de arquivos estáticos pré-buscados — sem chamadas de rede ao vivo durante o uso das ferramentas.

Ferramentas

Ferramenta	Descrição
`search_docs(query, limit?)`	Pesquisa por palavras-chave em títulos, slugs, trechos e grupos. Use esta ferramenta primeiro para encontrar o slug correto.
`list_docs_by_group(group)`	Lista todos os documentos de uma categoria (ex.: `"Framework Components"`).
`list_all_docs()`	Índice completo de todos os 58 documentos. Prefira as ferramentas acima.
`get_docs_for(slug)`	Retorna a documentação Markdown completa para um slug.
`list_themes()`	Lista todos os temas predefinidos disponíveis do Skeleton UI.
`get_theme_info(theme)`	Obtém tokens de design detalhados (cores, fontes, etc.) para um tema específico.
`get_theme_guide()`	Obtém orientações sobre configuração de temas e posicionamento de temas personalizados.

Configuração do Claude Desktop

Usando uvx (recomendado)

Nenhuma instalação necessária — uvx busca e executa o pacote automaticamente:

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

A partir do código-fonte

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

Atualizando os Arquivos Estáticos

O diretório skeleton_ui_mcp_server/static/ contém documentação pré-buscada de skeleton.dev. Para atualizá-lo manualmente:

uv run --extra fetch python index.py

Isso busca novamente todas as páginas listadas em skeleton_ui_mcp_server/static/_llms.txt e regenera os arquivos JSON individuais.

Um workflow do GitHub Actions (.github/workflows/update-static.yml) executa isso automaticamente todas as noites às 03:00 UTC e faz commit de quaisquer alterações de volta ao repositório. Também pode ser acionado manualmente via Actions → Update static docs → Run workflow. Os testes de integridade (tests/test_audit.py) são executados como parte do workflow antes do commit — se falharem, o commit é ignorado.

Garantia de Qualidade

Instale as dependências de desenvolvimento primeiro:

uv sync --group dev

Comando	O que faz
`uv run --group dev pytest -v`	Executa todos os testes (testes de fumaça das ferramentas + integridade estática)
`uv run --group dev pytest tests/test_tools.py -v`	Somente testes de ferramentas MCP
`uv run --group dev pytest tests/test_audit.py -v`	Somente testes de dados estáticos + formato `_llms.txt`
`uv run --group dev pyright`	Verificação de tipos de `server.py` e `index.py`
`uv run --group dev pip-audit`	Verifica dependências em busca de vulnerabilidades conhecidas