🇺🇦 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" 鏈接,點擊後會打開一封預填好的郵件。