LIBRAScript MCP

<p align="center"> <a href="https://github.com/fabricioartur/librascript-mcp"><img src="https://img.shields.io/badge/repo-GitHub-181717?logo=github" alt="GitHub"></a> <a href="https://github.com/fabricioartur/librascript-mcp/releases/tag/v0.3.0"><img src="https://img.shields.io/badge/version-0.3.0-blue" alt="version 0.3.0"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a> <img src="https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white" alt="Node 18+"> <img src="https://img.shields.io/badge/custo-R%24%200-brightgreen" alt="R$ 0"> </p>

Torne qualquer IA capaz de produzir conteúdo em LIBRAS usando as APIs oficiais do VLibras (Governo Digital).

Funciona com Cursor, Grok, Claude Desktop, Claude Code, OpenAI Codex, Google Antigravity e qualquer ferramenta que suporte o protocolo MCP.

---

Comece em 3 minutos

Opção A — clone do repositório (funciona hoje)

git clone https://github.com/fabricioartur/librascript-mcp.git
cd librascript-mcp
npm install
npm run build
npm run doctor
npm run demo

Texto personalizado na demo:

node dist/index.js --demo "Bem-vindo ao nosso curso de programação"

Configuração MCP local (edite o caminho absoluto): examples/mcp-local-dev.json

Opção B — npx (após publicar no npm)

npx -y librascript-mcp --doctor
npx -y librascript-mcp --demo "Bem-vindo ao nosso curso de programação"

Configuração MCP:

{
  "mcpServers": {
    "librascript": {
      "command": "npx",
      "args": ["-y", "librascript-mcp"]
    }
  }
}

Exemplos prontos: examples/mcp-cursor.json, examples/mcp-claude-desktop.json

Onde colocar a config

Ferramenta	Arquivo / local
Cursor	Configurações → MCP
Grok Build	Config MCP do projeto
Claude Desktop	~/.config/claude/claude_desktop_config.json (macOS/Linux)
OpenAI Codex	~/.codex/config.toml ou codex mcp add
Google Antigravity	MCP settings — documentação

Reinicie o editor após salvar a config.

---

O que pedir para a IA

Você não precisa saber os nomes das ferramentas. Basta escrever em português:

Você escreve	A IA faz
"Traduza para LIBRAS: Bem-vindo ao curso"	Traduz e valida
"Este texto está bom para LIBRAS?"	Audita antes de traduzir
"Gere o roteiro em LIBRAS deste parágrafo"	Traduz + roteiro com tempos
"Traduza cada slide abaixo"	Tradução em lote

Prompts prontos (se o seu cliente suportar)

• traduzir-para-libras — fluxo completo
• tornar-site-acessivel — audita README ou página web
• traduzir-slides — vários trechos de uma vez

---

Como funciona

flowchart LR
    A["IA com cliente MCP"]
    B["LIBRAScript MCP"]
    C["APIs VLibras"]
    D["Glossa + Validacao + Roteiro"]

    A -->|"Traduza para LIBRAS"| B
    B -->|"translate + bundles"| C
    C --> D
    D --> A

Etapa	O que acontece
1	Você pede à IA em português natural
2	A IA chama o LIBRAScript MCP
3	O MCP consulta as APIs do VLibras
4	Retorna glossa validada e roteiro com tempos estimados

Exemplo real:

Entrada	Bem-vindo ao nosso curso de programação
Glossa	BEM_VINDO NOSSO CURSO&ESTUDAR PROGRAMAÇÃO
Validação	100% dos sinais no dicionário oficial

---

O problema que resolve

No Brasil, mais de 2 milhões de pessoas usam LIBRAS como língua principal, mas a maior parte do conteúdo digital é produzida apenas em português escrito.

O VLibras traduz páginas para quem consome conteúdo (widget Ícaro). O LIBRAScript preenche a lacuna de quem cria conteúdo com IA — desenvolvedores, educadores, ONGs e criadores digitais.

---

Ferramentas em ação

flowchart TD
    T["Texto em portugues"]
    T --> A["audit_content"]
    A --> G["text_to_gloss"]
    G --> V["validate_gloss"]
    V --> S["gloss_to_script"]
    T -.->|"atalho"| TV["translate_and_validate"]
    TV --> S

Referência das ferramentas

Ferramenta	Para que serve
translate_and_validate	Comece por aqui — audita, traduz e valida
text_to_gloss	Só traduzir
validate_gloss	Conferir qualidade da glossa
audit_content	Melhorar o texto em português antes de traduzir
gloss_to_script	Roteiro com tempos para vídeo/aula
batch_translate	Vários trechos (slides, FAQ…)
lookup_sign	Buscar sinal no dicionário
submit_review	Enviar feedback ao VLibras
dictionary_stats	Quantos sinais existem no dicionário

---

Quem pode usar

Funciona	Não funciona diretamente
Cursor, Grok Build, Claude Desktop, Claude Code	ChatGPT no navegador (sem MCP)
OpenAI Codex, Google Antigravity, VS Code + MCP	Apps sem suporte ao protocolo

Requisitos: Node.js 18+, internet (APIs do governo).

Custo: R$ 0 — sem API key, sem cadastro.

---

Aviso importante

O VLibras não substitui um intérprete humano de LIBRAS.

Este projeto ajuda a preparar conteúdo (glossas, roteiros, revisões). Para aulas, vídeos publicados, audiências ou materiais oficiais, sempre envolva um fluente em LIBRAS na revisão final.

Fonte oficial

---

Problemas comuns

Problema	Solução
MCP não aparece	Reinicie o editor após salvar a config
command not found: node	Instale Node 18+ em nodejs.org
npx retorna 404	Pacote ainda não publicado — use Opção A (clone)
Erro de tradução	Rode npm run doctor — API do governo pode estar fora
Glossa com score baixo	Simplifique frases; use audit_content primeiro
Palavra soletrada	Normal se não há sinal no dicionário — use lookup_sign

---

Desenvolvimento local

npm install
npm run build
npm run doctor
npm run demo
npm start

Estrutura do projeto:

src/
  index.ts          # servidor MCP + prompts
  vlibras-client.ts # APIs do governo
  cli.ts            # --demo, --doctor, --help
  audit.ts          # auditoria de texto
  validation.ts     # validação de glossa
  script.ts         # roteiros
  gloss.ts          # parsing de glossa
  format.ts         # formatação de respostas
  doctor.ts         # verificação de saúde
  constants.ts      # URLs e avisos

APIs utilizadas (gratuitas):

• https://traducao2.vlibras.gov.br/translate
• https://dicionario2.vlibras.gov.br/bundles
• https://traducao2.vlibras.gov.br/review (feedback via submit_review)

Código oficial VLibras: github.com/spbgovbr-vlibras

---

Licença

MIT — integra serviços do VLibras (Software Público Brasileiro, LGPL-3.0).