MCP Texttranslation

🚀 MCP 翻譯服務

MCP 翻譯服務是基於小牛翻譯（NiuTrans）API 的 MCP Provider，為您提供文字翻譯工具和語種目錄資源。您可以輕鬆在 Cursor/mcp-cli 等客戶端中引用這些資源，實現便捷的翻譯功能。

🚀 快速開始

使用 uv 安裝並啟動發佈版

uv tool install mcp-translation-text

📦 安裝指南

環境變量

• NIUTRANS_API_KEY（必填）：這是小牛翻譯開放平臺提供的 API Key，您可以免費使用。請登錄該鏈接獲取。

📚 詳細文檔

計費說明

本服務使用小牛翻譯的文本翻譯 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。

📄 許可證

本項目包含 LICENSE 文件，具體的許可信息請查看該文件。