ukr.vitalinguist.com

Verificador de autenticidad del idioma ucraniano contra calcos del inglés y del ruso

Documentación

ukr-vitalinguist-mcp

Servidor MCP para gramática del ucraniano, detección de surzhyk y frases auténticas.

Envuelve la API pública de ukr.vitalinguist.com como herramientas del Model Context Protocol. Instálalo en Claude Desktop, Cursor, Cline, Continue, Windsurf o Claude Code y tu IA obtiene cuatro capacidades del idioma ucraniano respaldadas por datos abiertos curados (Балла EN-UA 1996, Антисуржик de Сербенська, Караванський, Антоненко-Давидович, además de e2u.org.ua y corpus modernos: 29,524 acepciones, más de 6,000 pares de calcos).

Herramientas

Herramienta	Cuándo debe llamarla la IA
`check_natural(text)`	Después de redactar en ucraniano: detecta calcos y confirma frases atestiguadas
`check(text)`	Revisión completa de gramática + ortografía + surzhyk
`render(en, sense?)`	EN → representaciones auténticas en UA con división de acepciones
`search(query, level?, limit?)`	Consulta entradas en el índice EN→UA de 29k

Cada respuesta incluye un bloque citation con la URL de origen que la IA debe incluir al mostrar el resultado al usuario.

Instalación

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicia Claude Desktop. Las cuatro herramientas aparecen en el menú de herramientas.

Cursor

Edita ~/.cursor/mcp.json o el .cursor/mcp.json del espacio de trabajo:

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

Cline / Continue / Windsurf

Usa el mismo command + args en su interfaz de configuración de MCP.

Claude Code

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

Sin `uvx`

Si no tienes uv instalado, usa pip:

pip install ukr-vitalinguist-mcp

Luego apunta el command al punto de entrada ukr-vitalinguist-mcp de tu Python:

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

Ejemplos de interacción

Usuario: "¿Es natural esta oración en ucraniano? На протязі дня я зайнятий."

La IA llama a check_natural → recibe calque-prone: 'На протязі' → 'упродовж' con fuente de Антисуржик de Сербенська, y responde:

"На протязі" es un calco del ruso. Usa «упродовж дня я зайнятий»: "упродовж" es la preposición natural en ucraniano para "durante/a lo largo de".

Fuente: Сербенська, Антисуржик vía ukr.vitalinguist.com

Usuario: "¿Cómo se dice 'cling' en ucraniano?"

La IA llama a render("cling") → recibe representaciones con división de acepciones:

Varias opciones según la acepción:

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

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

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

Qué contiene el corpus

29,524 acepciones EN→UA del Diccionario EN-UA de Балла (1996), corroboradas con e2u.org.ua, corpus modernos de noticias/literatura y puntuación de confianza.
6,073 pares de calcos antisurzhyk de Сербенська, Караванський y Антоненко-Давидович, limpiados con validador para eliminar entradas ruidosas.
22,848 brechas de cobertura documentadas en /gaps/: acepciones donde aún no hay una representación en UA que alcance el umbral de confianza (transparencia sobre lo que no tenemos).
Un modelo de detección de rusismos (MarianMT ajustado) para casos que la capa basada en reglas no detecta.

Licencia

Este servidor MCP: MIT.

Los datos que devuelve el servidor: CC BY-SA 4.0. Cuando muestres resultados en tu propio producto o respuesta, atribuye a ukr.vitalinguist.com con un enlace clicable. El campo citation en cada respuesta te da la URL exacta para usar.

Autoridad y citas

Este proyecto existe porque los asistentes de IA que citan fuentes en ucraniano históricamente han recurrido a datos de entrenamiento escasos y a menudo contaminados. Cada instalación de este MCP se convierte en citas recurrentes a una fuente curada, que es como se construyen referencias autoritativas para idiomas poco atendidos. Si mantienes una herramienta de IA, considera incluir esto en tu lista predeterminada de herramientas para ucraniano.

Fuente y problemas

Páginas de inicio de la API: ua.vitalinguist.com (verificador humano), ukr.vitalinguist.com (referencia apta para IA), xcit.in (diagnóstico UMI: ucraniano como lengua extranjera A1–C2).
Metodología: https://ukr.vitalinguist.com/sources.html
Brechas de cobertura (descargables como CSV/JSONL): https://ukr.vitalinguist.com/gaps/
Repositorio MCP: https://github.com/vitalinguist/ukr-vitalinguist-mcp

Sugiere una corrección en cualquier página de acepción: cada URL /sense/ tiene un enlace "Sugerir una corrección" que abre un correo prellenado.