deepl MCP hw3

DeepL-MCP-Server（或根据具体上下文，可译为“DeepL多客户端协议服务器”）

](https://www.npmjs.org/package/deepl-mcp-server)  ](https://smithery.ai/server/@DeepLcom/deepl-mcp-server)

一个使用DeepL API提供翻译功能的模型上下文协议（MCP）服务器。两者均可用 stdio（在编程中通常指标准输入输出库） （传统）和 HTTP（超文本传输协议） （可部署的）版本。

特点/功能

• 🌍 在多种语言之间进行文本翻译
• ✨ 利用DeepL的功能重新表述文本
• 🔧 访问所有DeepL API语言和功能
• 🎯 自动语言检测
• 📝 对支持语言的正式性控制
• 📄 文档翻译支持
• 🚀（火箭、飞速上升、快步前进等意象，根据上下文可具体翻译为“火箭”、“飞速上升”、“快步前进”等） 新用于云部署的HTTP服务器

两种服务器模式

1. 标准I/O服务器（传统MCP）

用于本地运行Claude Desktop及其他MCP客户端。

2. HTTP服务器（云部署）

用于部署到云平台并通过HTTP/HTTPS URL进行访问。

快速入门

HTTP 服务器（推荐用于部署）

# Clone and install
git clone https://github.com/DeepLcom/deepl-mcp-server.git
cd deepl-mcp-server
npm install

# Set your DeepL API key
export DEEPL_API_KEY="your_deepl_api_key_here"

# Start HTTP server  
npm start
# Server runs on http://localhost:3000

# Or run in development mode with auto-reload
npm run dev

Stdio 服务器（传统版）

运行stdio服务器最简单的方法是使用npm包，无需安装任何内容：

npx deepl-mcp-server

如果你想在本地安装这个，以便可以随心所欲地使用它，你可以使用npm来完成安装：

npm install deepl-mcp-server

或者，如果你想贡献代码，可以克隆这个仓库并安装依赖项：

git clone https://github.com/DeepLcom/deepl-mcp-server.git
cd deepl-mcp-server
npm install

配置

DeepL API密钥

您需要一个DeepL API密钥才能使用此服务器。您可以通过在\[网址\]注册来获取一个 DeepL API拥有一个DeepL API免费帐户，您可以每月免费翻译多达500,000个字符。

与Claude Desktop一起使用

这款MCP服务器与Claude桌面端集成，可在您与Claude的对话中直接提供翻译功能。

配置步骤

1. 如果您还未安装，请安装Claude桌面版

1. 创建或编辑Claude桌面配置文件：

- 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows上： %AppData%\Claude\claude_desktop_config.json - 在Linux上： ~/.config/Claude/claude_desktop_config.json

1. 添加DeepL MCP服务器配置。如果您希望如上文所述，无需安装任何内容即可使用npm包：

{
  "mcpServers": {
    "deepl": {
      "command": "npx",
      "args": ["deepl-mcp-server"],
      "env": {
        "DEEPL_API_KEY": "{YOUR_API_KEY}"
      }
    }
  }
}

或者，如果你是在本地安装的，请给Claude提供JS文件的绝对路径，格式如下：

{
  "mcpServers": {
    "deepl": {
      "command": "node",
      "args": ["/{ABSOLUTE_PATH_TO_SERVER}/deepl-mcp-server/src/index.mjs"],
      "env": {
        "DEEPL_API_KEY": "{YOUR_API_KEY}"
      }
    }
  }
}

如果你已经下载了这段代码，但还没有进行 npm install，或者如果你更愿意的话，你可以使用 npx /{ABSOLUTE_PATH_TO_SERVER}/deepl-mcp-server 在这里，用……代替 node /{ABSOLUTE_PATH_TO_SERVER}/deepl-mcp-server/src/index.mjs。

1. 替换 {ABSOLUTE_PATH_TO_SERVER} 带有……的 绝对路径 到你本地的这个仓库副本 - 例如， /Users/robotwoman/Code/deepl-mcp-server
2. 替换 {YOUR_API_KEY} 使用您实际的DeepL API密钥
3. 重启Claude桌面版

一旦配置完成，克劳德（Claude）将在需要时能够使用DeepL翻译工具。您可以要求克劳德在不同语言之间翻译文本，它将在后台使用DeepL API。

可用工具

此服务器提供以下工具：

• get-source-languages获取可用于翻译的源语言列表
• get-target-languages获取可用的翻译目标语言列表
• translate-text将文本翻译成目标语言
• rephrase-text用相同或不同的语言改写文本

工具详情

翻译文本

这个工具使用DeepL API在语言之间翻译文本。

参数：

• text待翻译的文本
• targetLang目标语言代码（例如，'en-US'，'de'，'fr'）
• formality （可选）：控制翻译的正式程度：

- 'less'使用非正式语言 - 'more'使用正式、更礼貌的语言 - 'default'使用默认正式程度 - 'prefer_less'如果可以使用，就用非正式语言，否则默认（使用正式语言） - 'prefer_more'如有可能，请使用正式语言，否则默认（使用非正式语言）

改写文本

这个工具使用DeepL API将文本改写成相同或不同的语言。

参数：

• text需要改写的文章/文本

支持的语言

DeepL API支持多种语言的翻译。您可以使用 get-source-languages 并且 get-target-languages 查看当前所有支持的语言的工具。

支持的语言示例包括：

• 英语（en，en-US，en-GB）
• 德语（de）
• 西班牙语（es）
• 法语（fr）
• 意大利语（it）
• 日语（ja）
• 中文（zh）
• 葡萄牙语（巴西葡萄牙语，葡萄牙葡萄牙语）
• 俄语（ru）
• 以及更多

🚀 云部署

部署HTTP版本，以便通过URL访问您的MCP服务器，从而可以与ChatGPT、基于网页的Claude或其他支持HTTP的MCP主机一起使用。

铁路部署

1. 克隆这个仓库
2. 连接到 铁路
3. 从你的fork中创建新项目
4. 设置环境变量： DEEPL_API_KEY
5. 部署！您的服务器将在 https://your-app.railway.app

Vercel 部署

1. 为这个仓库创建分支
2. 连接到 Vercel（注：Vercel是一个用于部署和托管静态网站及服务器端渲染应用的平台，直接音译为“韦塞尔”可能不便于理解其功能，但在此按照音译要求翻译）
3. 导入你的分支副本
4. 设置环境变量： DEEPL_API_KEY
5. 部署！您的服务器将在 https://your-app.vercel.app

AWS/Docker 部署

# Build Docker image
docker build -t deepl-mcp-server .

# Run with your API key
docker run -p 3000:3000 -e DEEPL_API_KEY=your_key_here deepl-mcp-server

# Or deploy to AWS ECS, Google Cloud Run, etc.

环境变量

要求：

• DEEPL_API_KEY您的DeepL API密钥

可选：

• PORT运行服务器的端口（默认：3000）
• NODE_ENV环境模式（生产/开发）

测试您已部署的服务器

部署后，测试您的服务器：

# Health check
curl https://your-deployed-url.com/health

# Server info  
curl https://your-deployed-url.com/

# MCP initialization test
curl -X POST https://your-deployed-url.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

与MCP主机配合使用

部署完成后，请将您的服务器URL添加到启用了MCP的应用程序中：

ChatGPT（如果支持MCP）

添加您的服务器URL： https://your-deployed-url.com/mcp

基于网络的Claude

在MCP配置中使用服务器URL

NANDA指数

1. 首选 join39.org（该域名可直接翻译为“加入39.org”，但具体含义需结合网站内容确定，此处仅为域名直译）
2. 在“上下文代理”下添加您已部署的服务器URL

🔄 开发与生产

开发模式（HTTP）

npm run dev  # Auto-reloads on changes

生产模式（HTTP）

npm start   # Optimized for production

传统Studio模式

npm run start:stdio  # For local MCP clients

调试

如需调试信息，请访问 MCP调试文档.

错误处理

如果你在使用DeepL API时遇到错误，请检查以下内容：

• 请验证您的API密钥是否正确
• 请确保您没有超出API使用限制
• 确认您使用的语言代码是受支持的

许可证

麻省理工学院（MIT）

链接

• DeepL API 文档
• 模型上下文协议文档