librascript-mcp
This server enables AI tools to produce and manage content in LIBRAS (Brazilian Sign Language) using the official VLibras APIs — no API key required.
Translate Portuguese text to LIBRAS gloss: Convert text (up to 5,000 characters) into a LIBRAS gloss string.
All-in-one workflow: Audit, translate, and validate in a single call — the recommended starting point.
Validate a LIBRAS gloss: Check which signs exist in the official VLibras dictionary and get a quality score.
Audit content before translating: Detect long sentences, acronyms, and hard-to-sign phrases to improve translation quality.
Generate a timed script: Turn a LIBRAS gloss into a production-ready script with estimated timings, ideal for videos or interpreters.
Batch translate: Translate up to 20 text segments at once (e.g., slide decks, FAQs).
Look up a sign: Check whether a specific word has a registered sign in the official dictionary.
Submit feedback: Rate translations and optionally provide corrected glosses to the VLibras team.
View dictionary statistics: See how many signs are currently loaded in the official dictionary.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@librascript-mcp Traduza para LIBRAS: Olá, como vai você?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 demoTexto 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 |
|
OpenAI Codex |
|
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 --> AEtapa | 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 |
|
Glossa |
|
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 --> SReferência das ferramentas
Ferramenta | Para que serve |
| Comece por aqui — audita, traduz e valida |
| Só traduzir |
| Conferir qualidade da glossa |
| Melhorar o texto em português antes de traduzir |
| Roteiro com tempos para vídeo/aula |
| Vários trechos (slides, FAQ…) |
| Buscar sinal no dicionário |
| Enviar feedback ao VLibras |
| 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.
Problemas comuns
Problema | Solução |
MCP não aparece | Reinicie o editor após salvar a config |
| Instale Node 18+ em nodejs.org |
| Pacote ainda não publicado — use Opção A (clone) |
Erro de tradução | Rode |
Glossa com score baixo | Simplifique frases; use |
Palavra soletrada | Normal se não há sinal no dicionário — use |
Desenvolvimento local
npm install
npm run build
npm run doctor
npm run demo
npm startEstrutura 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 avisosAPIs utilizadas (gratuitas):
https://traducao2.vlibras.gov.br/translatehttps://dicionario2.vlibras.gov.br/bundleshttps://traducao2.vlibras.gov.br/review(feedback viasubmit_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 toolsaudit_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
Scored across 9 tools
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.
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.
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.
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
Related MCP Connectors
YouTube transcripts for AI agents: text, JSON, SRT, or VTT in 150+ languages, with AI fallback.
Transcribe, subtitle, dub and lip-sync media; create speech, voices, images and thumbnails.
AI-native translation management: push translation files, translate, review and audit strings.
Transcribe, subtitle and dub videos into 100+ languages, and translate text.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI tools to Verblaze localization projects, enabling management of translations, languages, screens, and project resources through natural language interactions.14 npmMIT

AltText.ai MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI assistants to generate alt text, manage image libraries, and audit web pages for accessibility using the AltText.ai API.12MIT
mcp-gladiaofficial
FlicenseNot gradedqualityFmaintenanceEnables LLMs to transcribe, analyze, and translate audio/video content through Gladia's API.-- AlicenseNot gradedqualityBmaintenanceEnables AI agents to translate text, lists, and local documents through a LibreTranslate instance, detect languages, list supported languages, check service status, and submit translation suggestions over stdio or Streamable HTTP. It also exposes the raw LibreTranslate API through resource, describe, and call tools for broader operations.6 npmMIT