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

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:

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

Exemplo real:

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

Quem pode usar

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

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