🎯 Skills MCP Server - Global Command Integration

Expõe 1334 skills como ferramentas MCP globais em Claude Desktop, VSCode, Cursor e qualquer cliente compatível

O que faz

• 📚 Descobre automaticamente todas as skills em c:\skills (ao vivo, sem rebuild)

• 🗂️ Categoriza 1334 skills em 18 categorias com comandos dedicados por categoria

• 🔧 Expõe 24 ferramentas MCP: 18 de categoria + 6 gerais (incluindo busca semântica BM25)

• 🌐 Funciona em Claude Desktop, VSCode Copilot, Cursor, GitHub Copilot

Arquitetura

c:\skills\                    ← 1300+ skills (cada uma com SKILL.md)
         ├── agent-customization/
         │   └── SKILL.md
         ├── react-best-practices/
         │   └── SKILL.md
         └── ...

c:\mcp\                       ← MCP Server
     ├── mcp_server.py          ← Servidor principal (24 tools, FastMCP)
     ├── categorize_skills.py   ← Utilitário de auditoria de categorias
     ├── categories.json        ← Snapshot de categorias para auditoria
     ├── sync_cursor_rules.py   ← Sincroniza CLAUDE.md → Cursor User Rules
     ├── setup.py               ← Configura clientes automaticamente
     ├── pyproject.toml         ← Dependências (uv)
     ├── requirements.txt       ← Dependências (pip)
     └── README.md

Setup - 3 passos rápidos

1️⃣ Instalar dependências

# Recomendado (uv)
cd c:\mcp
uv sync

# Alternativa (pip)
pip install -r requirements.txt

2️⃣ Executar setup

cd c:\mcp
python setup.py

Ou usando o script PowerShell (recomendado para Windows):

.\setup.ps1

Isso configura automaticamente:

• ✅ Claude Desktop (%APPDATA%\Claude\claude_desktop_config.json)

• ✅ Cursor (~\.cursor\mcp.json)

• 📝 Exibe instruções para VSCode

3️⃣ Reiniciar as aplicações

Reinicie Claude Desktop, Cursor e/ou VSCode para carregar o servidor.

Ferramentas disponíveis (24 total)

Por categoria (18 tools)

Cada tool lista somente as skills da categoria, com ícone e contagem.

Todas aceitam parâmetro limit: int = 0 (0 = retorna todas da categoria)

Gerais (6 tools)

Exemplos de uso

# Listar skills de AI
list_ai_skills()
→ 🤖 AI & Agentes — 129 skills: agent-evaluation, agent-memory-mcp, ...

# Invocar uma skill específica
invoke_skill("react-best-practices", "como usar hooks corretamente?")
→ [retorna conteúdo completo do SKILL.md]

# Buscar por palavra
search_skills("docker")
→ [lista todas as skills com "docker" no nome]

# Ver todas as categorias
list_categories()
→ ♿ accessibility (8) | 🤖 ai (129) | ⚙️ backend (80) | ...

Categorização de skills

As skills são categorizadas automaticamente pelo nome da pasta usando regras de tokens, prefixos e substrings definidas em mcp_server.py (dict CATEGORY_RULES).

Para verificar categorias após adicionar novas skills:

python categorize_skills.py

A categorização em runtime é feita pelo servidor diretamente — o categories.json é apenas um snapshot para auditoria.

Distribuição atual (março 2026):

• 🚀 devops: 233 | 🤖 ai: 168 | 🔄 automation: 153 | ✅ testing: 109

• ⚙️ backend: 94 | 🎨 frontend: 91 | 📝 content: 88 | 🔒 security: 81

• 💻 language: 63 | 🏗️ architecture: 60 | 💼 business: 33 | 📱 mobile: 27

• 📊 data: 22 | ♿ accessibility: 9 | 🔗 web3: 8 | 🎮 gamedev: 7

• 📦 other: 298 (skills meta/pessoais sem categoria técnica)

• 77.7% das skills categorizadas em categorias específicas

Estrutura de uma SKILL.md

# Nome da Skill

Descrição brevíssima do que a skill faz.

## Uso

Como usar, exemplos, contexto...

O servidor lê o título (H1), extrai metadados e usa o conteúdo completo como contexto.

Adicionar uma nova skill

1. Crie a pasta: c:\skills\{nome-da-skill}\

2. Crie o arquivo: c:\skills\{nome-da-skill}\SKILL.md

3. Rode python categorize_skills.py para atualizar o cache de categorias

4. O servidor já descobre a skill na próxima chamada (sem restart)

Troubleshooting

Skills não aparecem

python -c "from mcp_server import get_skills; print(len(get_skills()))"

Claude Desktop / Cursor não conecta

1. Verifique uv no PATH: uv --version

2. Verifique o config: %APPDATA%\Claude\claude_desktop_config.json

3. Reinicie completamente o cliente

VSCode não reconhece as tools

• Verifique settings.json (ver output do python setup.py)

• Reinicie o VSCode

Slash Commands por Cliente

Memória Global Dinâmica

Sincronizar regras com o Cursor

# Ver o que será gravado (dry-run)
python c:/mcp/sync_cursor_rules.py --show

# Sincronizar (feche o Cursor antes)
python c:/mcp/sync_cursor_rules.py

# Limpar
python c:/mcp/sync_cursor_rules.py --clear

Links

• 📖 MCP Spec 2025-11-25

• 🚀 FastMCP Docs

• 🧩 VSCode MCP Guide

• 🖱️ Cursor MCP Guide

Criado: 26 de março de 2026
Atualizado: 29 de março de 2026
Versão: 2.2
Skills: 1334 | Categorias: 18 | Tools MCP: 24
Status: ✅ Pronto para produção