klhq/skillmux

O que skillmux faz?

Servidor MCP local somente leitura que roteia consultas de tarefas em linguagem natural para habilidades em um vault SKILL.md, com entrega sem perda de dados.

Introdução

O klhq/skillmux é um servidor MCP (Model Context Protocol) que opera localmente em modo somente leitura. Ele indexa e gerencia habilidades (skills) definidas em arquivos SKILL.md armazenados em um vault. Quando um usuário ou agente de IA envia uma consulta de tarefa em linguagem natural, o servidor roteia a requisição para a habilidade mais relevante no vault, garantindo que todo o contexto da consulta seja preservado na resposta.

Principais Recursos

• Roteamento Inteligente: Consultas em linguagem natural são automaticamente correspondidas às habilidades mais adequadas com base em seus metadados.
• Entrega Sem Perda: O contexto completo da interação é mantido, evitando perda de informações entre etapas.
• Modo Somente Leitura: O vault não é modificado pelo servidor, garantindo a integridade dos dados.
• Suporte a Múltiplas Plataformas: Compatível com agentes de IA como Claude Code, Cursor e Codex.

Como Funciona

1. O vault contém um conjunto de arquivos SKILL.md, cada um descrevendo uma habilidade específica com metadados como nome, descrição e plataformas suportadas.
2. O servidor klhq/skillmux indexa esses arquivos ao iniciar, criando um repositório pesquisável.
3. Quando uma consulta de tarefa é enviada (ex.: "Preciso configurar um novo projeto Node.js"), o servidor analisa a consulta e a corresponde à habilidade mais relevante.
4. A resposta inclui a habilidade selecionada e seu conteúdo, sem perda de contexto.

Exemplo de Uso

# Exemplo de consulta usando o servidor MCP
query_tool --server klhq/skillmux --request "Organizar meus arquivos de projeto"

O servidor retornará a habilidade relevante para organização de arquivos, se disponível no vault.

Considerações Técnicas

• O servidor é executado localmente, não exigindo conexão externa.
• Apenas arquivos SKILL.md no vault são indexados; outros formatos são ignorados.
• A correspondência de consultas é baseada em similaridade semântica e metadados, garantindo alta precisão.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Qualquer agente compatível com o protocolo MCP

Licença

Este projeto é distribuído sob os termos da licença MIT. Consulte o arquivo LICENSE para mais detalhes.