🎯 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.

Tool	Categoria	Skills
list_accessibility_skills	♿ Acessibilidade	9
list_ai_skills	🤖 AI & Agentes	191
list_backend_skills	⚙️ Backend	123
list_frontend_skills	🎨 Frontend	122
list_devops_skills	🚀 DevOps & Cloud	238
list_security_skills	🔒 Segurança	89
list_testing_skills	✅ Testing & QA	114
list_mobile_skills	📱 Mobile	29
list_data_skills	📊 Data Engineering	38
list_automation_skills	🔄 Automação	171
list_architecture_skills	🏗️ Arquitetura	79
list_language_skills	💻 Linguagens	75
list_content_skills	📝 Conteúdo & Marketing	97
list_gamedev_skills	🎮 GameDev	8
list_business_skills	💼 Negócios & Startups	53
list_web3_skills	🔗 Web3 & Blockchain	8
list_health_skills	🏥 Saúde & Bem-estar	17
list_legal_skills	⚖️ Jurídico & Legal	9

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

Gerais (6 tools)

Tool	O que faz
invoke_skill(skill_name, params)	Lê e retorna o SKILL.md completo de uma skill
search_skills(query)	Busca por substring no nome/categoria
semantic_search_skills(query, top_k)	Busca semântica BM25 — entende contexto, multi-token, sinônimos parciais
list_categories()	Lista todas as categorias disponíveis com contagens
list_all_skills(page, per_page)	Lista todas as 1334 skills com paginação
refresh_skills()	Força reload imediato do cache (sem restart)

---

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

Cliente	Sintaxe	Status
Claude Desktop	/ai, /backend, /oliverplan	✅ nativo
Claude Code	/ai, /backend, /oliverplan	✅ nativo
VS Code Copilot	/skills.ai, /skills.backend, /skills.oliverplan	✅ funciona
Cursor	não suporta MCP Prompts	❌ use linguagem natural

Memória Global Dinâmica

Cliente	Mecanismo	Como atualizar
Claude Desktop / Code	~/.claude/CLAUDE.md	edite e salve
VS Code Copilot	~/.claude/CLAUDE.md (auto-detectado)	edite e salve
Cursor	Cursor Settings → Rules (SQLite)	python c:/mcp/sync_cursor_rules.py

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