Skip to main content
Glama

LIBRAScript MCP

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.


Related MCP server: AltText.ai MCP Server

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

Available Tools

9 tools
audit_contentA

Analisa um texto em português ANTES de traduzir. Detecta frases longas, siglas e trechos difíceis de assinar.

Inputs: text (required).

batch_translateC

Traduz vários trechos de uma vez (slides, seções, FAQ). Máximo 20 itens.

Inputs: texts (required).

dictionary_statsA

Mostra quantos sinais existem no dicionário oficial carregado.

Inputs: no named parameters.

gloss_to_scriptC

Transforma uma glossa em roteiro com tempos estimados. Ideal para vídeos, aulas gravadas e intérpretes.

Inputs: gloss (required), title.

lookup_signA

Busca um sinal no dicionário oficial VLibras. Use para conferir se uma palavra tem sinal cadastrado.

Inputs: term (required), limit.

submit_reviewA

Envia feedback à equipe VLibras quando uma tradução estiver boa ou precisar de correção.

Inputs: text (required), translation (required), rating (required), suggestion.

text_to_glossA

Traduz um texto em português para glossa LIBRAS. Use quando o usuário pedir tradução para LIBRAS, língua de sinais ou VLibras.

Inputs: text (required).

translate_and_validateA

Atalho recomendado: audita, traduz e valida em uma única chamada. Use para a maioria dos pedidos de tradução.

Inputs: text (required), auditFirst.

validate_glossA

Valida uma glossa e mostra quais sinais existem no dicionário. Use sempre após traduzir.

Inputs: gloss (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation4/5

    Most tools have distinct purposes, but text_to_gloss and translate_and_validate could be confused as both involve translation. Descriptions help clarify: translate_and_validate is an all-in-one shortcut while text_to_gloss is a standalone step. Similarly, batch_translate and translate_and_validate might overlap for multiple items, but batch_translate is for without audit.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., audit_content, batch_translate, lookup_sign). No deviations or mixed conventions are present, making the naming predictable and easy to parse.

    Tool Count5/5

    With 9 tools, the server is well-scoped for its purpose of translating Portuguese to LIBRAS. Each tool covers a specific step in the workflow (audit, translate, batch, validate, lookup, script generation, stats, feedback) without unnecessary bloat or missing essentials.

    Completeness4/5

    The tool surface covers the core translation workflow end-to-end, including audit, translation, validation, and feedback. Minor gaps exist, such as a tool for direct audio/video translation or user account management, but these are reasonable omissions for the stated domain.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers