{"id":14527,"library":"deepl-mcp-server","title":"DeepL Model Context Protocol (MCP) Server","description":"The deepl-mcp-server package provides a Model Context Protocol (MCP) server that integrates DeepL's translation capabilities. It allows other applications, notably Claude Desktop, to leverage DeepL's API for features like text and document translation, rephrasing, automatic language detection, formality control, and glossary support. The current stable version is 1.1.0. This package is primarily designed as a standalone server or CLI tool, rather than a library for programmatic import. Its key differentiator is simplifying DeepL API access for MCP-compatible clients, particularly its direct configuration support for Claude Desktop, enabling AI assistants to perform high-quality translations. Release cadence is infrequent, focusing on stability and integration enhancements. It abstracts the complexities of the DeepL API, offering a streamlined interface via the MCP specification.","status":"active","version":"1.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/DeepLcom/deepl-mcp-server","tags":["javascript","deepl","mcp","translation","claude","ai"],"install":[{"cmd":"npm install deepl-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add deepl-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add deepl-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is primarily a command-line interface (CLI) and server process. It is meant to be executed, not imported as a library into other JavaScript applications.","wrong":"import { translate } from 'deepl-mcp-server'","symbol":"deepl-mcp-server","correct":"npx deepl-mcp-server"},{"note":"The DeepL API Key is a mandatory environment variable for server operation. It is not an importable JavaScript symbol.","wrong":"import { DEEPL_API_KEY } from 'deepl-mcp-server'","symbol":"DEEPL_API_KEY","correct":"DEEPL_API_KEY=\"{YOUR_API_KEY}\" npx deepl-mcp-server"},{"note":"For direct execution of the local source (e.g., during development), the main ESM entry point `index.mjs` can be run with `node`. Direct import of internal modules for programmatic use is generally not supported or recommended.","wrong":"import * as server from 'deepl-mcp-server/src/index.mjs'","symbol":"index.mjs","correct":"node /path/to/your/deepl-mcp-server/src/index.mjs"}],"quickstart":{"code":"DEEPL_API_KEY=\"YOUR_DEEPL_API_KEY\" npx deepl-mcp-server &\n\n# Wait a moment for the server to start (it typically runs on port 3000 by default, though not explicitly stated)\n# Assuming it runs on default port 3000, as is common for Node.js servers\n\n# Test with a simple request to get available source languages\ncurl -X POST -H \"Content-Type: application/json\" \\\n  -d '{ \"tool_code\": \"get-source-languages\", \"tool_name\": \"get-source-languages\" }' \\\n  http://localhost:3000/v1/tools/call\n\n# Example to translate text\n# This call structure is based on the MCP specification, which might require a more complex payload\n# The actual body for translate-text would involve 'text', 'target_lang', 'source_lang'\n# For this quickstart, we'll demonstrate a conceptual call.\n\n# Note: Replace 'YOUR_DEEPL_API_KEY' with an actual key to run successfully.\n# The server logs its port on startup; adjust http://localhost:3000 if different.","lang":"bash","description":"This quickstart demonstrates how to launch the DeepL MCP server via npx with an API key, then interact with it using curl to call one of its available tools, like fetching source languages."},"warnings":[{"fix":"Set the `DEEPL_API_KEY` environment variable before running the server (e.g., `DEEPL_API_KEY=\"your_key\" npx deepl-mcp-server`).","message":"A DeepL API key is absolutely essential for the server to function. Without it, translation requests will fail. Sign up at DeepL API to obtain one.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Run the server as a separate process using `npx deepl-mcp-server` or `node /path/to/src/index.mjs`. Interact with it via HTTP requests from your application.","message":"This package is designed as a standalone server and command-line tool, not a library for direct programmatic import into other JavaScript or TypeScript applications. Attempting to `import` or `require` it as a module for in-process use will likely fail or lead to unsupported behavior.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use a full path like `/Users/youruser/Code/deepl-mcp-server/src/index.mjs` in your Claude Desktop configuration (`claude_desktop_config.json`).","message":"When installing locally and configuring for Claude Desktop, ensure you provide an *absolute path* to the `index.mjs` file or the installed package directory. Relative paths will cause Claude Desktop to fail finding and launching the server.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Inspect the console output when the server starts to confirm the active port, and adjust any client requests (e.g., `curl`) accordingly.","message":"The server's exact port is not explicitly stated as configurable in the provided README. It's common for Node.js servers to default to `3000` or `8080`, but this might vary or be configurable through unmentioned environment variables. Check server startup logs for the exact port.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-19T00:00:00.000Z","next_check":"2026-07-18T00:00:00.000Z","problems":[{"fix":"Set the `DEEPL_API_KEY` environment variable, e.g., `DEEPL_API_KEY=\"YOUR_KEY\" npx deepl-mcp-server`.","cause":"The DeepL API key was not provided when starting the server.","error":"DEEPL_API_KEY is not defined. Please set it as an environment variable."},{"fix":"Ensure `npx` is installed and updated (`npm install -g npm@latest`) or install the package globally (`npm install -g deepl-mcp-server`). Alternatively, provide the full path to the executable if running locally.","cause":"The `deepl-mcp-server` command is not available in the current shell's PATH, or `npx` is not installed/configured.","error":"command not found: deepl-mcp-server"},{"fix":"Verify the `command` and `args` paths in your `claude_desktop_config.json` are correct and absolute, and that the specified `DEEPL_API_KEY` is valid. Check Claude Desktop logs for more specifics.","cause":"Claude Desktop encountered an issue reading or executing the command defined for the 'deepl' MCP server in `claude_desktop_config.json`.","error":"Failed to load MCP server config for 'deepl'"}],"ecosystem":"npm"}