MCP Texttranslation

🚀 MCP 翻訳サービス

小牛翻訳（NiuTrans）API をベースにした MCP Provider です。テキスト翻訳ツールと言語カタログリソースを提供し、Cursor/mcp-cli などのクライアントで簡単に参照できます。

🚀 クイックスタート

uv を使ってリリース版をインストールし起動する

uv tool install mcp-translation-text

📚 環境変数

• NIUTRANS_API_KEY（必須）：小牛翻訳オープンプラットフォームが提供する API Key で、無料で使用できます。ログイン後に取得できます:https://niutrans.com/cloud/account_info/info

📊 課金について

このサービスは小牛翻訳のテキスト翻訳 API を使用しており、課金ルールは以下の通りです。

💡 使用ヒント

毎日無料で付与される 100 ポイントは日常の使用に十分です。超過分は小牛翻訳オープンプラットフォームで充電して購入できます。

💻 MCP クライアント設定例

uv tool install でインストールした場合、mcp.json に以下のように記述できます。

{
  "mcpServers": {
    "translation": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "mcp-translation-text"
      ],
      "env": {
        "NIUTRANS_API_KEY": "${env.NIUTRANS_API_KEY}"
      }
    }
  }
}

Cursor を起動した後、ListTools を実行すると translate_text が表示されます。同時に ListResources で language://catalog を読み取ることもサポートしています。

✨ 利用可能な機能

ツール：translate_text

• パラメータ：
  • text：翻訳する内容。
  • source：ソース言語のコードまたは別名（ローカルマッピングテーブルで正規化されます）。
  • target：ターゲット言語のコードまたは別名。
• 戻り値：

  {
    "source": "zh",
    "target": "en",
    "original_text": "你好",
    "translated_text": "Hello",
    "raw": { ... 小牛の元のレスポンス ... }
  }
  

リソース：language://catalog

利用可能なすべての言語と別名を提供します。例は以下の通りです。

{
  "total": 455,
  "languages": [
    {"code": "zh", "zh": "中文(简体)", "en": "Chinese (Simplified)"},
    {"code": "en", "zh": "英语", "en": "English"}
    // ... その他省略 ...
  ],
  "aliases": {
    "zhongwenjianti": "zh",
    "english": "en"
    // ... その他省略 ...
  }
}

クライアントの LLM でこのリソースを先に読み取り、言語記述をコードにマッピングしてから translate_text を呼び出すことをおすすめします。

🔧 デバッグとよくある問題

• API Key が不足している場合：起動時に 環境変数 NIUTRANS_API_KEY が不足しています というエラーが表示されたら、.env またはシステム環境に設定されていることを確認してください。
• 言語がサポートされていない場合：translate_text では言語コード/別名が検証されます。エラーが発生した場合は、language://catalog に記載されている値を使用しているか確認してください。
• パスまたは依存関係の問題：スクリプトは uv に依存しています。まず pip install uv を実行してインストールするか、uv ドキュメントを参照してください。
• コマンド名に関する問題：PyPI でインストールした後は、直接 mcp-translation-text を実行できます。global PATH で見つからない場合は、仮想環境をアクティブ化するか、python -m mcp_translation_text を使用してください。
• パッケージのリリース/アップグレード：

  python -m build
  twine upload dist/*
  

📂 ディレクトリ構造（重要なファイル）

E:\MCP
├── pyproject.toml
├── server.py                # エントリーポイントのラッパー。python server.py で実行可能
├── src/
│   └── translation_server.py
├── scripts/
│   ├── start.ps1
│   └── start.sh
├── .env.example
├── LICENSE
└── README.md

リリース後、ユーザーは NiuTrans API Key を設定するだけで、mcp-translation-text を通じてこの Provider を直接ロードできます。