Ukrainian Language Reference (vitalinguist)

ukr-vitalinguist-mcp

用于乌克兰语语法、surzhyk 检测和地道表达的 MCP 服务。

将公开的 ukr.vitalinguist.com API 封装为 Model Context Protocol 工具。安装到 Claude Desktop、Cursor、Cline、Continue、Windsurf 或 Claude Code 后，你的 AI 就能获得四项乌克兰语能力，背后由精选的开放数据提供支持 （Балла EN-UA 1996、Сербенська 的 Антисуржик、Караванський、Антоненко-Давидович， 以及 e2u.org.ua 和现代语料库——29,524 个义项、6k+ 组对应表达）。

工具

工具	AI 应在何时调用
check_natural(text)	起草乌克兰语后调用——检测仿译表达，并确认表达有据可查
check(text)	全面检查语法、拼写和 surzhyk
render(en, sense?)	EN → 地道的 UA 译法，并按义项区分
search(query, level?, limit?)	在 29k 条 EN→UA 索引中查找词条

每条响应都包含一个 citation 区块，其中提供 AI 向用户展示结果时 应附上的来源 URL。

安装

Claude Desktop

在以下路径添加配置：~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

重启 Claude Desktop。四项工具会显示在工具菜单中。

Cursor

编辑 ~/.cursor/mcp.json 或工作区中的 .cursor/mcp.json：

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

Cline / Continue / Windsurf

在它们的 MCP 配置界面中使用相同的 command + args。

Claude Code

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

不使用 uvx

如果你没有安装 uv，请使用 pip：

pip install ukr-vitalinguist-mcp

然后将 command 指向 Python 中的 ukr-vitalinguist-mcp 入口点：

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

交互示例

用户：“这句乌克兰语自然吗？На протязі дня я зайнятий.”

AI 调用 check_natural → 返回 calque-prone: 'На протязі' → 'упродовж' ，来源为 Сербенська 的 Антисуржик，并回复：

“На протязі”是来自俄语的仿译表达。应使用 «упродовж дня я зайнятий»—— “упродовж”是乌克兰语中表示“在……期间／贯穿始终”的自然介词。

来源：Сербенська，Антисуржик，见 ukr.vitalinguist.com

---

用户：“乌克兰语里的 ‘cling’ 怎么说？”

AI 调用 render("cling") → 返回按义项区分的译法：

根据具体义项，有几种说法：

• cling (on) to sth（用身体抓住）：горнутися、чіплятися
• cling to a belief：триматися (чогось)

完整词条：ukr.vitalinguist.com/sense/cling

语料库内容

• 29,524 个 EN→UA 义项，来自 Балла EN-UA Dictionary (1996)，并经 e2u.org.ua、现代新闻／文学语料库和置信度评分交叉验证。
• 6,073 组反 surzhyk 仿译对应表达，来源于 Сербенська、Караванський 和 Антоненко-Давидович，并经验证器清理以剔除噪声词条。
• /gaps/ 中有 22,848 条已记录的覆盖空缺——这些义项目前还没有 乌克兰语译法达到置信度阈值（如实说明我们尚未涵盖的内容）。
• 一个用于检测基于规则的层漏检情况的 俄语特征检测模型（经过微调的 MarianMT）。

许可证

此 MCP 服务：MIT。

服务返回的数据：CC BY-SA 4.0。在你自己的产品或回复中展示结果时，请注明 ukr.vitalinguist.com 并附上可点击的链接。每条响应中的 citation 字段都会提供 可直接使用的确切 URL。

权威性与引用

这个项目旨在解决一个问题：AI 助手引用乌克兰语来源时，过去一直依赖稀少且常受污染的训练 数据。每次安装此 MCP，都会促成对精选来源的持续引用——这正是为服务不足的语言建立权威参考资料的方式。 如果你是 AI 工具维护者，不妨将其纳入默认的乌克兰语工具列表。

来源与问题

• API 主页：ua.vitalinguist.com（人工校验器）、ukr.vitalinguist.com（便于 AI 使用的参考资料）、xcit.in（UMI 诊断工具——乌克兰语作为外语，A1–C2）。
• 方法论：https://ukr.vitalinguist.com/sources.html
• 覆盖缺口（可下载为 CSV/JSONL）：https://ukr.vitalinguist.com/gaps/
• MCP 仓库：https://github.com/vitalinguist/ukr-vitalinguist-mcp

可在任何义项页面上提出更正建议——每个 /sense/ URL 都有一个“提出更正建议”链接，点击后会打开一封预填内容的电子邮件。