deepseek-translate-server 0.1.7

MCP server for translating Markdown to Chinese via DeepSeek

deepseek-translate MCP Server

将 Markdown 文本翻译为中文的 MCP server，基于 DeepSeek API。

安装

uv sync

运行

uv run deepseek-translate-server
# 或安装后
uvx deepseek-translate-server

环境变量

• DEEPSEEK_API_KEY：必需，DeepSeek API key。

uvx 启动时不会自动加载 pdf2md 目录下的 .env。需要在 MCP host 配置里通过 env 传入，或在启动 server 的 shell 环境中 export。

工具

translate_md

翻译单段 Markdown 文本或单个文件。

参数：

• text: Markdown 文本（与 file_path 二选一）
• file_path: 本地 Markdown 文件路径（与 text 二选一）
• model: DeepSeek 模型，默认 deepseek-v4-flash
• temperature: 采样温度，默认 0.3
• thinking: 是否开启 reasoning，默认 False
• max_chunk_chars: 大文本自动分块阈值，默认 8000
• concurrency: 分块翻译最大并发数，默认 100

超过阈值的大文本会自动分块翻译，优先按 PaddleOCR full.md 中的页面分隔符切分，避免单次请求超时。

返回：翻译后的 Markdown 文本。

translate_md_dir

并发翻译目录下所有 Markdown 文件。短目录可直接使用；大批量目录建议用 translate_md_dir_start，避免 MCP Host 前台调用超时。

参数：

• dir_path: 目录路径
• pattern: 文件匹配模式，默认 *.md
• model: DeepSeek 模型，默认 deepseek-v4-flash
• temperature: 采样温度，默认 0.3
• thinking: 是否开启 reasoning，默认 False
• concurrency: 最大并发数，默认 100
• max_chunk_chars: 单个文件内大文本自动分块阈值，默认 8000

行为：

• 优先翻译 dir_path/pages/ 下的文件；若不存在则翻译 dir_path 根目录文件
• 对每个匹配文件生成 {stem}_trans.md，放在与源文件相同目录
• 按文件名排序合并为 dir_path/full_trans.md
• 返回合并后的文件路径

translate_md_dir_start

启动后台目录翻译任务，立即返回任务状态，适合大文件或多文件翻译。参数与 translate_md_dir 相同。

返回字段包括：

• job_id: 后续查询任务状态使用的 ID
• status: queued / running / succeeded / failed
• total: 需要翻译的源文件数
• completed: 已完成文件数
• completed_files: 已完成文件名
• merged_path: 成功后生成的合并译文路径
• error: 失败原因

translate_job_status

查询 translate_md_dir_start 启动的后台任务。

参数：

• job_id: 后台翻译任务 ID

接入 MCP Host

{
  "mcpServers": {
    "deepseek-translate": {
      "command": "uvx",
      "args": ["deepseek-translate-server"],
      "env": {
        "DEEPSEEK_API_KEY": "your-api-key"
      }
    }
  }
}