sankhya-mcp

Projeto em fase inicial — novas versões e funcionalidades em breve.

Servidor MCP (Model Context Protocol) para documentação do Sankhya ERP, com busca semântica local via RAG. Permite que o Claude (VS Code, Claude Desktop, etc.) responda perguntas precisas sobre o sistema Sankhya — sem chaves de API, sem configuração de infraestrutura, sem latência de rede.

Como funciona

O conhecimento fica embutido no pacote como um índice vetorial local (sqlite-vec). O servidor roda localmente via STDIO e responde às queries do Claude com os trechos de documentação mais relevantes.

Você pergunta ao Claude sobre o Sankhya
              ↓
Claude chama search_docs (MCP tool)
              ↓
Servidor busca no índice local (sem API externa)
              ↓
Claude responde com base na documentação do Sankhya

Instalação

Pré-requisito

É necessário ter o uv instalado na sua máquina:

curl -LsSf https://astral.sh/uv/install.sh | sh

O uv é um gerenciador de pacotes Python moderno e ultrarrápido. Ele será usado automaticamente pelo npx para instalar as dependências do servidor.

VS Code / Claude Code

Crie ou edite o arquivo .mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "sankhya-docs": {
      "command": "npx",
      "args": ["sankhya-mcp"]
    }
  }
}

Claude Desktop

Edite o arquivo claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sankhya-docs": {
      "command": "npx",
      "args": ["sankhya-mcp"]
    }
  }
}

Reinicie o Claude Desktop após salvar.

Uso pessoal (instalação global)

Se preferir instalar globalmente na sua máquina em vez de usar npx:

npm install -g sankhya-mcp

E no arquivo de configuração do Claude, use:

{
  "mcpServers": {
    "sankhya-docs": {
      "command": "sankhya-mcp"
    }
  }
}

Coleções disponíveis

Exemplos de perguntas

• Como exportar XMLs de NF-e no Sankhya?
• Como criar um dashboard HTML5?
• Como otimizar queries para dashboards?
• Como reabrir uma ordem de produção?
• Como corrigir apontamentos de OP com quantidade errada?
• Como emitir boletos em lote?
• O que fazer quando uma OP está com quantidade incorreta?

Stack

• Python 3.12+
• MCP Python SDK + FastMCP
• sqlite-vec — índice vetorial embutido
• fastembed — embeddings locais (sem API externa)
• Modelo: paraphrase-multilingual-MiniLM-L12-v2 (384 dims, multilingual)

Contribuindo

Este projeto é uma iniciativa livre e aberta. Qualquer pessoa pode contribuir — seja adicionando documentação, melhorando a qualidade da busca, corrigindo erros ou sugerindo novas funcionalidades.

Como contribuir:

• Abra uma Issue para reportar erros ou sugerir melhorias
• Envie um Pull Request com novos documentos ou correções
• Compartilhe o projeto com outros usuários do Sankhya

Status

Este projeto está em fase inicial de desenvolvimento. Em breve:

• Novas coleções de documentação
• Melhorias na qualidade da busca
• Suporte a mais módulos do Sankhya ERP

Achou útil?

Se este projeto te ajudou, considere dar uma estrela no GitHub — isso ajuda outras pessoas a encontrarem o projeto!

dar uma estrela no GitHub