cezarpretto/spechub-mcp repository overview

⁠SpecHub MCP Server

Servidor MCP centralizado para armazenamento e busca de especificações técnicas com embeddings vetoriais. Memória compartilhada entre agentes de IA (Cursor, Claude Code, Windsurf) e times de desenvolvimento.

⁠Stack

• Mastra v1 (framework MCP com SSE/HTTP)
• PostgreSQL + pgvector (busca híbrida: vetorial + full-text)
• @xenova/transformers com paraphrase-multilingual-MiniLM-L12-v2 (384 dimensões, 50+ idiomas, roda 100% local, sem API externa)
• Express + Google OAuth 2.0 (autenticação opcional)

⁠Quick start

docker pull cezarpretto/spechub-mcp:latest

docker run -d \
  --name spechub \
  -p 3456:3456 \
  -e DATABASE_HOST=host.docker.internal \
  -e DATABASE_PORT=5434 \
  -e DATABASE_USER=spechub \
  -e DATABASE_PASSWORD=spechub \
  -e DATABASE_NAME=spechub \
  -v spechub-model-cache:/app/.cache \
  cezarpretto/spechub-mcp:latest

No primeiro startup o modelo de embedding (~470 MB) é baixado e armazenado em /app/.cache. As migrações do banco rodam automaticamente. Ferramentas MCP

• save_spec — persiste documento com embedding vetorial
• search_spec_context — busca semântica com top-3 trechos relevantes
• get_feature_overview — estrutura de headings e metadados
• get_section — conteúdo completo de uma seção por heading
• get_repo_tasks — tarefas ativas vinculadas à spec, por repositório
• update_task_status — atualiza status ou cria nova tarefa
• update_spec_chunk — edita seção da spec e re-indexa embedding Toda escrita registra changelog com autor e timestamp.

⁠Repositório

https://github.com/cezarpretto/spec-hub⁠