DeepL MCP 서버

DeepL 번역 기능을 제공하는 MCP(Model Context Protocol) 서버입니다.

특징

이 서버는 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
종속성 설치:
npm install # or # yarn install
서버를 빌드하세요:
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 시스템에 컴파일된 서버 파일의 실제 절대 경로로 바꾸고, YOUR_DEEPL_API_KEY 실제 DeepL API 키로 바꾸세요.

클라인/루 코드(VS 코드 확장)

MCP 서버용 VS Code 설정을 엽니다. macOS에서는 일반적으로 ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json 에 있습니다 . (참고: 정확한 경로는 운영 체제 및 VS Code 설치 유형(예: Insiders)에 따라 다를 수 있습니다.)
mcpServers 키 아래에 다음 구성 블록을 추가합니다.
"deepl-translator": { "command": "node", "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- IMPORTANT: Replace with your DeepL API Key }, "disabled": false, "alwaysAllow": [] }

클로드 데스크톱 앱

Claude Desktop App 구성 파일을 엽니다. macOS에서는 일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있습니다 . (참고: 정확한 경로는 운영 체제에 따라 다를 수 있습니다.)
mcpServers 키 아래에 다음 구성 블록을 추가합니다.
"deepl-translator": { "command": "node", "args": ["/path/to/your/deepl-mcp-server/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "DEEPL_API_KEY": "YOUR_DEEPL_API_KEY" // <-- IMPORTANT: Replace with your DeepL API Key }, "disabled": false, "alwaysAllow": [] }

용법

구성이 완료되면 use_mcp_tool 명령/도구를 사용하여 AI 어시스턴트에서 서버 도구를 호출할 수 있습니다.

`list_languages` 예제

<use_mcp_tool>
  <server_name>deepl-translator</server_name>
  <tool_name>list_languages</tool_name>
  <arguments>
    {
      "type": "target" // Optional: "source" or "target". Defaults to listing all if omitted.
    }
  </arguments>
</use_mcp_tool>

`translate_text` 예제

<use_mcp_tool>
  <server_name>deepl-translator</server_name>
  <tool_name>translate_text</tool_name>
  <arguments>
    {
      "text": ["Hello world", "How are you?"], // Required: An array of strings to translate
      "target_lang": "DE", // Required: Target language code (e.g., DE, FR, ES)
      "source_lang": "EN" // Optional: Source language code. DeepL will auto-detect if omitted.
    }
  </arguments>
</use_mcp_tool>

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.