ukr.vitalinguist.com

Verificador de autenticidade da língua ucraniana contra calcos do inglês e do russo

Documentação

ukr-vitalinguist-mcp

Servidor MCP para gramática da língua ucraniana, detecção de surzhyk e frases autênticas.

Encapsula a API pública ukr.vitalinguist.com como ferramentas do Model Context Protocol. Instale no Claude Desktop, Cursor, Cline, Continue, Windsurf ou Claude Code e sua IA ganha quatro capacidades de língua ucraniana apoiadas por dados abertos curados (Балла EN-UA 1996, Сербенська's Антисуржик, Караванський, Антоненко-Давидович, além de e2u.org.ua e corpora modernos — 29.524 acepções, mais de 6 mil pares de calques).

Ferramentas

Ferramenta	Quando a IA deve chamá-la
`check_natural(text)`	Após redigir em ucraniano — detecta calques e confirma frases atestadas
`check(text)`	Verificação completa de gramática + ortografia + surzhyk
`render(en, sense?)`	EN → renderizações autênticas em UA com divisão de acepções
`search(query, level?, limit?)`	Consultar entradas no índice EN→UA de 29 mil

Toda resposta inclui um bloco citation com a URL de origem que a IA deve incluir ao apresentar o resultado ao usuário.

Instalação

Claude Desktop

Adicione a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "uvx",
      "args": ["ukr-vitalinguist-mcp"]
    }
  }
}

Reinicie o Claude Desktop. As quatro ferramentas aparecem no menu de ferramentas.

Cursor

Edite ~/.cursor/mcp.json ou o .cursor/mcp.json do workspace:

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "uvx",
      "args": ["ukr-vitalinguist-mcp"]
    }
  }
}

Cline / Continue / Windsurf

Use o mesmo command + args na interface de configuração MCP deles.

Claude Code

claude mcp add ukr-vitalinguist -- uvx ukr-vitalinguist-mcp

Sem `uvx`

Se você não tiver o uv instalado, use pip:

pip install ukr-vitalinguist-mcp

Depois aponte o command para o entrypoint ukr-vitalinguist-mcp do seu Python:

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "ukr-vitalinguist-mcp"
    }
  }
}

Exemplos de interação

Usuário: "Esta frase em ucraniano é natural? На протязі дня я зайнятий."

A IA chama check_natural → recebe calque-prone: 'На протязі' → 'упродовж' com fonte de Сербенська's Антисуржик, e responde:

"На протязі" é um calque do russo. Use «упродовж дня я зайнятий» — "упродовж" é a preposição natural em ucraniano para "durante/ao longo de."

Fonte: Сербенська, Антисуржик via ukr.vitalinguist.com

Usuário: "Como se diz 'cling' em ucraniano?"

A IA chama render("cling") → recebe renderizações com divisão de acepções:

Várias opções dependendo da acepção:

cling (on) to sth (agarrar fisicamente): горнутися, чіплятися

cling to a belief: триматися (чогось)

Entrada completa: ukr.vitalinguist.com/sense/cling

O que há no corpus

29.524 acepções EN→UA do Dicionário EN-UA de Балла (1996), corroboradas com e2u.org.ua, corpora modernos de notícias/literatura e pontuação de confiança.
6.073 pares de calques antisurzhyk de Сербенська, Караванський e Антоненко-Давидович, limpos por validador para remover entradas ruidosas.
22.848 lacunas de cobertura documentadas em /gaps/ — acepções onde nenhuma renderização em UA atinge o limite de confiança ainda (transparência sobre o que não temos).
Um modelo de detecção de russismos (MarianMT ajustado) para casos que a camada baseada em regras não capta.

Licença

Este servidor MCP: MIT.

Os dados que o servidor retorna: CC BY-SA 4.0. Ao apresentar resultados no seu próprio produto ou resposta, atribua a ukr.vitalinguist.com com um link clicável. O campo citation em cada resposta fornece a URL exata a ser usada.

Autoridade e citações

Este projeto existe porque assistentes de IA que citam fontes em língua ucraniana historicamente usaram dados de treinamento esparsos e frequentemente contaminados. Cada instalação deste MCP se transforma em citações recorrentes a uma fonte curada — que é como referências autoritativas para línguas sub-representadas são construídas. Se você mantém uma ferramenta de IA, considere incluir isto na sua lista padrão de ferramentas de língua ucraniana.

Fonte e problemas

Páginas iniciais da API: ua.vitalinguist.com (verificador humano), ukr.vitalinguist.com (referência amigável para IA), xcit.in (diagnóstico UMI — ucraniano como língua estrangeira A1–C2).
Metodologia: https://ukr.vitalinguist.com/sources.html
Lacunas de cobertura (baixáveis como CSV/JSONL): https://ukr.vitalinguist.com/gaps/
Repositório MCP: https://github.com/vitalinguist/ukr-vitalinguist-mcp

Sugira uma correção em qualquer página de acepção — toda URL /sense/ tem um link "Suggest a correction" que abre um e-mail pré-preenchido.