O que mcp-skill-hub faz?
Servidor MCP local para busca semântica de habilidades com aprendizado baseado em uso para o Claude Code.
Visão Geral
Este servidor MCP permite que o Claude Code encontre a skill certa para a tarefa certa, usando embeddings semânticos e dados de uso históricos para priorizar resultados. Em vez de depender apenas de palavras-chave, ele entende o significado da sua consulta e aprende com suas escolhas ao longo do tempo.
Funcionalidades
- Busca semântica: Encontre skills relevantes mesmo quando os termos de pesquisa não correspondem exatamente aos nomes ou descrições.
- Aprendizado baseado em uso: Os resultados são ponderados com base na frequência com que você usa cada skill em diferentes cenários.
- Cache local: As habilidades são indexadas localmente para resposta rápida sem dependência de rede.
- Fácil integração: Funciona como um servidor MCP padrão, compatível com Claude Code e outros clientes MCP.
Como Funciona
- O servidor carrega e indexa as definições de skills de um diretório local.
- Cada skill é convertida em um embedding semântico usando um modelo leve.
- Quando o Claude Code faz uma consulta, o servidor calcula a similaridade do cosseno entre a consulta e todos os embeddings das skills.
- Os resultados são reordenados com base em um fator de popularidade que reflete o uso histórico.
- As principais skills correspondentes são retornadas para uso imediato.
Configuração
Adicione o seguinte ao seu arquivo de configuração MCP (geralmente .claude/mcp.json):
{
"mcpServers": {
"skill-hub": {
"command": "npx",
"args": [
"-y",
"@ccancellieri/mcp-skill-hub",
"--skills-dir", "./skills"
]
}
}
}
Parâmetros
--skills-dir: Caminho para o diretório contendo os arquivos de skill (obrigatório).--port: Porta para o servidor MCP (opcional, padrão: 3100).--model: Modelo de embedding a ser usado (opcional, padrão:all-MiniLM-L6-v2).
Uso
Depois de configurado, o Claude Code pode chamar a ferramenta search_skills diretamente:
search_skills(query: "precisa de uma skill para deploy no Kubernetes")
O servidor retornará uma lista classificada de skills correspondentes, com as mais relevantes e usadas com frequência no topo.
Estrutura de Dados
As skills devem estar em arquivos Markdown com frontmatter YAML opcional:
---
name: deploy-k8s
description: Faz deploy de aplicações em clusters Kubernetes
tags: [kubernetes, deploy, devops]
---
# deploy-k8s
Esta skill automatiza o deploy de contêineres no Kubernetes...
Licença
MIT