Metadata-Version: 2.4
Name: deepseek-translate-server
Version: 0.1.2
Summary: MCP server for translating Markdown to Chinese via DeepSeek
Requires-Python: >=3.13
Requires-Dist: fastmcp>=3.4.2
Requires-Dist: openai>=1.65.0
Description-Content-Type: text/markdown

# deepseek-translate MCP Server

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

## 安装

```bash
uv sync
```

## 运行

```bash
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`

返回：翻译后的 Markdown 文本。

### `translate_md_dir`

并发翻译目录下所有 Markdown 文件。

参数：

- `dir_path`: 目录路径
- `pattern`: 文件匹配模式，默认 `*.md`
- `model`: DeepSeek 模型，默认 `deepseek-v4-flash`
- `temperature`: 采样温度，默认 `0.3`
- `thinking`: 是否开启 reasoning，默认 `False`
- `concurrency`: 最大并发数，默认 `10`

行为：

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

## 接入 MCP Host

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