Ukr Vitalinguist MCP

🚀 ukr-vitalinguist-mcp

ウクライナ語の文法・スルジク(surzhyk)検出・本物の言い回しのための MCP サーバー

公開 API ukr.vitalinguist.com を Model Context Protocol ツールとしてラップしたものです。 Claude Desktop・Cursor・Cline・Continue・Windsurf・Claude Code にインストールすると、 厳選されたオープンデータに裏打ちされた 4 つのウクライナ語機能 が AI に加わります (Балла EN-UA 1996、Сербенська の Антисуржик、Караванський、Антоненко-Давидович、 さらに e2u.org.ua や現代コーパス — 29,524 語義、6,000 以上のカルクペア)。

✨ ツール一覧

すべてのレスポンスには 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 を再起動すると、4 つのツールがツールメニューに表示されます。

Cursor

~/.cursor/mcp.json またはワークスペースの .cursor/mcp.json を編集します:

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

Cline / Continue / Windsurf

それぞれの MCP 設定 UI で同じ 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 辞典(1996)に由来し、 e2u.org.ua・現代のニュース／文学コーパス・信頼度スコアリングで裏付け。
• 6,073 件の反スルジク(antisurzhyk)カルクペア — Сербенська・Караванський・ Антоненко-Давидович に由来し、バリデータでノイズ項目を除去済み。
• 22,848 件の文書化されたカバレッジギャップ — /gaps/ にて公開。まだ信頼度閾値を 満たすウクライナ語表現が存在しない語義を収録(持っていないものを透明に開示)。
• ロシア語的表現(russianism)検出モデル(ファインチューニング済み 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 には "Suggest a correction" リンクがあり、事前入力済みのメールが開きます。