返回 MCP 目录
public公开dns本地运行

deepl-mcp-server

一个基于DeepL API的MCP服务器,提供文本翻译和语言列表功能。

article

README

🚀 DeepL MCP 服务器

本项目是一个基于 Model Context Protocol (MCP) 的服务器,它提供了 DeepL 翻译功能,能帮助用户轻松实现文本翻译及获取支持语言列表等操作。

🚀 快速开始

本服务器借助 MCP 提供了便捷的翻译及语言列表获取工具,可助力用户高效完成语言相关操作。

✨ 主要特性

此服务器通过 MCP 提供以下实用工具:

  • translate_text:利用 DeepL API 在不同语言间翻译一个或多个文本字符串。
  • list_languages:获取 DeepL API 支持的语言列表(包括源语言和目标语言)。

📦 安装指南

先决条件

  • Node.js 和 npm/yarn:这是安装依赖项和运行服务器的必备工具。
  • DeepL API 密钥:您需要一个来自 DeepL 的 API 密钥,免费计划和 Pro 计划均提供 API 访问权限。如需注册或了解更多信息,请访问 https://www.deepl.com/pro-api

安装步骤

  1. 克隆仓库
git clone https://github.com/watchdealer-pavel/deepl-mcp-server.git
cd deepl-mcp-server
  1. 安装依赖项
npm install
# 或
# yarn install
  1. 构建服务器
npm run build

该命令会将 TypeScript 源代码编译为 JavaScript,并将输出放置在 build/ 目录中(具体为 build/index.js)。

📚 详细文档

配置

服务器需要您通过 DEEPL_API_KEY 环境变量提供 DeepL API 密钥。您需配置 MCP 客户端(如 Cline/Roo Code 或 Claude Desktop App)来运行此服务器并传递环境变量。

示例配置

以下是常见 MCP 客户端的配置示例,请记得将 /path/to/your/deepl-mcp-server/build/index.js 替换为您系统上的实际 build/index.js 绝对路径,并将 YOUR_DEEPL_API_KEY 替换为您的真实 DeepL API 密钥。

Cline / Roo Code(VS Code 插件)

  1. 打开 VS Code 的 MCP 服务器设置。在 macOS 上,通常位于: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json (注意:具体路径可能因操作系统和 VS Code 安装类型(如 Insider)而异。)
  2. mcpServers 关键字下添加以下配置块:
"deepl-translator": {
  "command": "node",
  "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- 重要: 替换为实际的 build/index.js 绝对路径
  "env": {
    "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- 重要: 替换为您的 DeepL API 密钥
  },
  "disabled": false,
  "alwaysAllow": []
}

Claude Desktop App

  1. 打开 Claude Desktop App 的配置文件。在 macOS 上,通常位于: ~/Library/Application Support/Claude/claude_desktop_config.json (注意:具体路径可能因操作系统而异。)
  2. mcpServers 关键字下添加以下配置块:
"deepl-translator": {
  "command": "node",
  "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- 重要: 替换为实际的 build/index.js 绝对路径
  "env": {
    "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- 重要: 替换为您的 DeepL API 密钥
  },
  "disabled": false,
  "alwaysAllow": []
}

📄 许可证

该项目遵循 MIT License 进行授权,如需详细信息,请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端