🇺🇦 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) |
完整语法 + 拼写 + 混合语检查 |
render(en, sense?) |
英语 → 地道乌克兰语表达,并附义项拆分 |
search(query, level?, limit?) |
在 29k 条 EN→UA 索引中查询条目 |
💡 使用提示
每次响应都包含一个 citation 块,内含来源 URL。AI 在向用户展示结果时应当引用该链接。
📦 安装指南
🖥️ 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: 'На протязі' → 'упродовж',来源为 Сербенська 的《Антисуржик》,并回复:
"На протязі" 是来自俄语的仿译。应使用 «упродовж дня я зайнятий» ——
"упродовж" 才是表示 "during/throughout" 的地道乌克兰语介词。
来源:Сербенська, Антисуржик via 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 词典(1996),并与 e2u.org.ua、现代新闻/文学语料库交叉验证,附置信度评分。
- 6,073 组反混合语仿译词对:来自 Сербенська、Караванський 与 Антоненко-Давидович,经校验器清洗以剔除噪声条目。
- 22,848 条已记录的覆盖缺口:位于
/gaps/ —— 即尚无达到置信度阈值的乌克兰语表达的义项(对我们所缺失的内容保持透明)。
- 一个 俄语化检测模型(微调版 MarianMT):用于规则层遗漏的场景。
📄 许可证
本 MCP 服务器:MIT。
服务器返回的数据:CC BY-SA 4.0。当你在自己的产品或回答中展示结果时,请署名 ukr.vitalinguist.com 并附上可点击链接。每次响应中的 citation 字段会给出应当使用的确切 URL。
🔬 权威性与引用
本项目的存在,是因为 AI 助手在引用乌克兰语来源时,历史上常常取材于稀疏、甚至被污染的训练数据。每一次安装本 MCP,都会转化为对某个经过策展的来源的持续引用 —— 这正是为服务不足的语言构建权威参考的方式。如果你是 AI 工具维护者,建议将其加入你默认的乌克兰语工具列表。
🔗 来源与问题反馈
💡 使用建议
可在任意义项页面提交修正 —— 每个 /sense/ URL 都有一个 "Suggest a correction" 链接,点击后会打开一封预填好的邮件。