MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Local NLLB translation for 200+ languages. Zero cloud, zero cost, runs entirely on your machine.
この種の作業を AI に教える Skill。これと一緒に使えます
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 0/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 3/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 3/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
MCP Local Translate をインストールして。https://mcp.popnx.com/i/damoqiongqiu-mcp-local-translate.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server MCP Local Translate を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "local-translate": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Local Translate のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
SettingsDeveloperEdit Config
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}MCP Local Translate を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が MCP Local Translate を使っていると言うか、回答に MCP Local Translate のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
HF_ENDPOINT HuggingFace endpoint override for downloading models (e.g. https://hf-mirror.com for China).HF_AUTO_MIRROR 中国向け HuggingFace ミラーを自動検出します。'0' または 'false' に設定すると無効になります。 CACHE_DIR Transformers.js モデルをキャッシュするディレクトリ(デフォルトは ./models/) TRANSLATE_DEVICE 実行デバイス:'cpu'(デフォルト)または GPU アクセラレーション用の 'webgpu'。 HTTPS_PROXY モデルのダウンロードに使うプロキシの URL です。HTTP_PROXY および小文字の変数もサポートします。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ MCP Local Translate につなげません
MCP Local Translate はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · MCP Local Translate につなげるアプリを使う
Claude Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server MCP Local Translate を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translate 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Local Translate のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translateMCP Local Translate が一覧にあり、接続済みと表示されれば OK です
MCP Local Translate を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が MCP Local Translate を使っていると言うか、回答に MCP Local Translate のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
HF_ENDPOINT HuggingFace endpoint override for downloading models (e.g. https://hf-mirror.com for China).HF_AUTO_MIRROR 中国向け HuggingFace ミラーを自動検出します。'0' または 'false' に設定すると無効になります。 CACHE_DIR Transformers.js モデルをキャッシュするディレクトリ(デフォルトは ./models/) TRANSLATE_DEVICE 実行デバイス:'cpu'(デフォルト)または GPU アクセラレーション用の 'webgpu'。 HTTPS_PROXY モデルのダウンロードに使うプロキシの URL です。HTTP_PROXY および小文字の変数もサポートします。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server MCP Local Translate を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "local-translate": { "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Local Translate のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
MCP Local Translate を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が MCP Local Translate を使っていると言うか、回答に MCP Local Translate のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
HF_ENDPOINT HuggingFace endpoint override for downloading models (e.g. https://hf-mirror.com for China).HF_AUTO_MIRROR 中国向け HuggingFace ミラーを自動検出します。'0' または 'false' に設定すると無効になります。 CACHE_DIR Transformers.js モデルをキャッシュするディレクトリ(デフォルトは ./models/) TRANSLATE_DEVICE 実行デバイス:'cpu'(デフォルト)または GPU アクセラレーション用の 'webgpu'。 HTTPS_PROXY モデルのダウンロードに使うプロキシの URL です。HTTP_PROXY および小文字の変数もサポートします。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server MCP Local Translate を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "local-translate": { "type": "stdio", "command": "npx", "args": [ "-y", "@damoqiongqiu/mcp-local-translate" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Local Translate のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
MCP Local Translate を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が MCP Local Translate を使っていると言うか、回答に MCP Local Translate のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
HF_ENDPOINT HuggingFace endpoint override for downloading models (e.g. https://hf-mirror.com for China).HF_AUTO_MIRROR 中国向け HuggingFace ミラーを自動検出します。'0' または 'false' に設定すると無効になります。 CACHE_DIR Transformers.js モデルをキャッシュするディレクトリ(デフォルトは ./models/) TRANSLATE_DEVICE 実行デバイス:'cpu'(デフォルト)または GPU アクセラレーション用の 'webgpu'。 HTTPS_PROXY モデルのダウンロードに使うプロキシの URL です。HTTP_PROXY および小文字の変数もサポートします。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user local-translate -- npx -y @damoqiongqiu/mcp-local-translateClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"local-translate": {
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"local-translate": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@damoqiongqiu/mcp-local-translate"
]
}
}
}HF_ENDPOINT envHF_AUTO_MIRROR envCACHE_DIR envTRANSLATE_DEVICE envHTTPS_PROXY env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント damoqiongqiu で確認済みです
コードの最終更新:4 か月前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に @damoqiongqiu/mcp-local-translate@0.1.11 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/damoqiongqiu-mcp-local-translate)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は4 か月前、最新バージョン(0.1.11)がレジストリに届いたのは4 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| これ MCP Local Translate | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | パソコンにインストールが必要 |
| キーが必要 | いいえ | いいえ | いいえ | はい | いいえ | いいえ |
| Claude で + から追加 | いいえ | いいえ | いいえ | いいえ | はい | いいえ |
| 基本チェック | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| ライセンス | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
🍴 Inspired by shinpr/mcp-local-rag — original architecture patterns by Shinsuke Kagawa
AI 编程助手的本地翻译引擎。基于 NLLB-200 模型,支持 200+ 语言互译——完全离线,数据不离开你的机器。为多语言开发、文档阅读、代码注释翻译而生。
📖 English
zho_Hans)、ISO 639-1 简码(zh)、语言名称(Chinese)、中文别名(中文)——自动映射到正确的模型输入。npx 命令搞定。无需 Docker、Python、GPU。可通过 MCP 或 CLI 使用。Cursor — 添加到 ~/.cursor/mcp.json:
{
"mcpServers": { "local-translate": { "command": "npx", "args": ["-y", "@damoqiongqiu/mcp-local-translate"], "env": { "CACHE_DIR": "/path/to/models" } } } }
Codex — 添加到 ~/.codex/config.toml:
[mcp_servers.local-translate]
command = "npx" args = ["-y", "@damoqiongqiu/mcp-local-translate"]
[mcp_servers.local-translate.env] CACHE_DIR = "/path/to/models"
Claude Code — 运行以下命令:
claude mcp add local-translate --scope user --env CACHE_DIR=/path/to/models -- npx -y @damoqiongqiu/mcp-local-translate
WorkBuddy — 打开「设置 → 自定义连接器 → 添加自定义连接器」:
{
"mcpServers": { "local-translate": { "command": "npx", "args": ["-y", "@damoqiongqiu/mcp-local-translate"], "env": { "CACHE_DIR": "/path/to/models" } } } }
⚠️ 首次添加后,必须在「自定义连接器」列表中点击「信任」按钮,否则 MCP 服务器不会启动。这是 WorkBuddy 的安全机制——未经信任的自定义连接器会被静默阻止。
重启工具后即可使用:
你: "把这段文档翻译成中文"
助手: [返回翻译结果]
你: "This error message is in Japanese — what does it say?" 助手: 那是「データベース接続に失敗しました」—— 数据库连接失败。
你: "列出所有支持的翻译语言" 助手: 共 204 种语言,包括 中文、英语、日语、法语...
也可直接作为 CLI 使用——无需启动 MCP 服务器:
npx @damoqiongqiu/mcp-local-translate translate "Hello, world!" --source en --target zh
npx @damoqiongqiu/mcp-local-translate list-languages --query "chinese"
就这些。无需 Docker,无需 Python,无需配置服务器。
你的 AI 编程助手可以帮你写代码,但当你面对非母语的文档、注释、错误日志时,仍然需要跳出编程环境去复制粘贴到在线翻译工具。
隐私。 把代码片段或内部文档粘贴到 Google Translate 本质上是数据泄露。这个工具完全在本地运行——没有人能看到你的文本。
离线可用。 配置完成后无需联网即可使用——飞机上、咖啡店无 WiFi、空气间隙环境。
低资源语言。 NLLB-200 覆盖了 Google Translate 和 DeepL 不支持的小语言(如藏语、维吾尔语、高棉语等)。
成本。 无需为翻译 API 付费。只需一次模型下载(~600MB),然后无限使用。
mcp-local-translate 提供两种接口:MCP 服务器(供 AI 编程工具使用)和 CLI(供终端直接使用)。
MCP 服务器提供 2 个工具:translate 和 list_languages。
"把这段 React hooks 文档翻译成中文"
"Translate the error message to English" "这段日语注释是什么意思?"
translate 工具接受:
| 参数 | 类型 | 说明 |
|---|---|---|
text | string | 待翻译文本 |
source_lang | string | 源语言代码(auto 自动检测) |
target_lang | string | 目标语言代码 |
语言代码支持三种格式:
zho_Hans(简体中文)、eng_Latn(英语)、jpn_Jpan(日语)zh、en、ja、fr、de中文、英语、日语、韩语"这个翻译引擎支持多少种语言?"
"看看有没有藏语"
使用 list_languages 工具,可选 query 参数进行关键词过滤。
所有 MCP 工具也可以通过 CLI 命令使用——无需启动 MCP 服务器:
# 翻译文本
npx @damoqiongqiu/mcp-local-translate translate "Hello, world!" --source en --target zh
npx @damoqiongqiu/mcp-local-translate translate "Bonjour le monde" --source auto --target en
npx @damoqiongqiu/mcp-local-translate list-languages
npx @damoqiongqiu/mcp-local-translate list-languages --query "chinese"
⚠️ CLI 不会读取你的 MCP 客户端配置(
mcp.json、config.toml等)。通过命令行标志或环境变量配置 CLI,如下所示。
简要:
当你调用 translate 时:
zho_Hans),再查 ISO 639-1 别名表(zh → zho_Hans),最后查中文别名表(中文 → zho_Hans)。如果全部失败,进行模糊搜索并给出建议。/(?<=[.!?。!?\n])\s+/),确保不截断到句子中间。每块加上源语言和目标语言标记。Xenova/nllb-200-distilled-600M)翻译。模型通过懒加载初始化——首次翻译时下载并加载到内存,后续调用复用同一管道。MCP 服务器仅通过环境变量配置——通过 MCP 客户端的 env 块传入。
| 环境变量 | 默认值 | 描述 |
|---|---|---|
CACHE_DIR | 系统默认 | 模型缓存目录。NLLB-200 模型(~600MB)自动下载到此。建议使用绝对路径。 |
HF_ENDPOINT | https://huggingface.co | HuggingFace 镜像端点。设置后跳过自动镜像检测。 |
HF_AUTO_MIRROR | true | 自动镜像检测开关。设为 false 禁用。默认开启,首次下载前自动探测三级镜像链:huggingface.co → hf-mirror.com → modelscope.cn。 |
HTTPS_PROXY | (未设置) | HTTP 代理地址,用于下载模型(如 http://127.0.0.1:7890)。通过 setGlobalDispatcher 全局生效。 |
TRANSLATE_DEVICE | cpu | 推理设备。直接传给 Transformers.js。目前仅推荐 cpu。 |
性能
在 MacBook Pro M1(16GB RAM)、Node.js 22 上测试:
首次启动:
翻译速度:
内存:空闲 ~300MB,翻译峰值 ~1.2GB
故障排查
症状:启动日志中出现 fetch failed 或模型加载超时。
原因与排查:
huggingface.co 会超时。首选方案:不用配置 — mcp-local-translate 默认自动探测三级镜像链:huggingface.co → hf-mirror.com → modelscope.cn,逐级回退直到找到可用镜像。
备选方案:配置代理:
"env": {
"HTTPS_PROXY": "http://127.0.0.1:7890" }
手动指定镜像:
"env": {
"HF_ENDPOINT": "https://hf-mirror.com" }
CACHE_DIR 目录存在且包含 Xenova/nllb-200-distilled-600M/ 子目录。如果之前用不同的 CACHE_DIR 下载过模型,更新路径指向已有缓存即可避免重复下载。 rm -rf ~/.npm/_npx/
运行 list_languages 查看所有支持的语言及其代码。语言代码是 FLORES-200 格式(如 zho_Hans、eng_Latn),也可以使用 ISO 639-1 简码(如 zh、en)或中文别名(如 中文、英语)。
NLLB-200 在 CPU 上运行,翻译速度取决于你的硬件。长文本会被自动分块处理,每块约 2-3 秒。
常见问题
这真的私密吗? 是的。在模型下载之后,没有任何数据离开你的机器。可用网络监控验证。
可以离线使用吗? 可以,只要 NLLB-200 模型已缓存到本地。
与 Google Translate / DeepL 相比如何? 云端服务翻译质量更高(更大模型、更多训练数据),但需要将数据发送到外部。这个工具用一些质量换取完全隐私和零成本。
支持哪些语言? NLLB-200 支持 200+ 种语言。运行 list_languages 查看完整列表。
支持方言吗? NLLB-200 覆盖部分方言变体(如巴西葡萄牙语 por_Latn、拉美西班牙语等),但不像主流语言那样广泛。具体取决于模型训练数据。
翻译质量怎么样? 对主流语言对(英↔中、英↔法、英↔西等),600M 蒸馏模型提供不错的翻译质量。对低资源语言,质量会下降——可读但不保证优雅。
多用户支持? 不支持。专为单用户本地访问设计。
开发
git clone https://github.com/damoqiongqiu/mcp-local-translate.git
cd mcp-local-translate pnpm install
pnpm run type-check # TypeScript 检查
pnpm run check:fix # Lint 和格式化 pnpm run build # 编译
src/
index.ts # 入口点 — 路由到 CLI 或 MCP 服务器 server-main.ts # MCP 服务器启动 server/ index.ts # MCP 工具处理器(translate、list_languages) types.ts # MCP 工具定义 translator/ index.ts # 核心翻译引擎(NLLB-200 管道、分块、懒加载) connectivity.ts # 镜像检测与代理配置 language-codes.ts # FLORES-200 语言代码与解析器 utils/ # 共享工具 skills/ # 随包发布的 Agent Skills
Agent Skills 提供优化的提示词,帮助 AI 助手更有效地使用翻译工具:
# Claude Code(项目级别)
npx @damoqiongqiu/mcp-local-translate skills install --claude-code
npx @damoqiongqiu/mcp-local-translate skills install --claude-code --global
npx @damoqiongqiu/mcp-local-translate skills install --codex
Skills 包括:
欢迎贡献!参见 CONTRIBUTING.md 了解环境搭建和指南。
MIT License。免费用于个人和商业用途。
架构模式参考 mcp-local-rag by Shinsuke Kagawa。使用 Model Context Protocol by Anthropic 和 Transformers.js 构建。翻译模型:NLLB-200 by Meta AI。