librascript-mcp

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).