# deepl/claude-plugin architecture

> Architecture diagram of the GitHub repository deepl/claude-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deepl/claude-plugin
- Repository: https://github.com/deepl/claude-plugin

## Overview

This repository is a Claude plugin that exposes DeepL capabilities: translation, writing improvement, glossary access, and document translation. The documented user flow is Claude using the plugin to access DeepL; the README also notes that sign-in occurs when access is first needed. The tree contains plugin metadata, MCP configuration, and translation-rule skill instructions, but no implementation excerpts, so capability-specific wiring is not inferred.

Main entry points: [`.mcp.json`](https://github.com/deepl/claude-plugin/blob/main/.mcp.json) (MCP configuration), [`.claude-plugin/plugin.json`](https://github.com/deepl/claude-plugin/blob/main/.claude-plugin/plugin.json) (Plugin manifest), [`skills/translation-rules/SKILL.md`](https://github.com/deepl/claude-plugin/blob/main/skills/translation-rules/SKILL.md) (Translation rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_claude_plugin["Claude plugin"]
  node_plugin_manifest["Plugin manifest<br/>[plugin.json]"]
  node_mcp_config["MCP configuration<br/>[.mcp.json]"]
  node_translation_rules["Translation rules<br/>[SKILL.md]"]
end

subgraph group_deepl_capabilities["DeepL capabilities"]
  node_translation["Translation<br/>[.mcp.json]"]
  node_writing_improvement["Writing improvement<br/>[.mcp.json]"]
  node_glossary["Glossary access<br/>[.mcp.json]"]
  node_document_translation["Document translation<br/>[.mcp.json]"]
end

node_user(("User"))
node_claude(("Claude"))
node_deepl{{"DeepL"}}

node_user -->|"requests work"| node_claude
node_claude -->|"uses plugin"| node_plugin_manifest
node_claude -->|"uses guidance"| node_translation_rules
node_claude -->|"connects through"| node_mcp_config
node_mcp_config -->|"enables"| node_translation
node_mcp_config -->|"enables"| node_writing_improvement
node_mcp_config -->|"enables"| node_glossary
node_mcp_config -->|"enables"| node_document_translation
node_translation -->|"accesses"| node_deepl
node_writing_improvement -->|"accesses"| node_deepl
node_glossary -->|"accesses"| node_deepl
node_document_translation -->|"accesses"| node_deepl

click node_plugin_manifest "https://github.com/deepl/claude-plugin/blob/main/.claude-plugin/plugin.json"
click node_mcp_config "https://github.com/deepl/claude-plugin/blob/main/.mcp.json"
click node_translation_rules "https://github.com/deepl/claude-plugin/blob/main/skills/translation-rules/SKILL.md"
click node_translation "https://github.com/deepl/claude-plugin/blob/main/.mcp.json"
click node_writing_improvement "https://github.com/deepl/claude-plugin/blob/main/.mcp.json"
click node_glossary "https://github.com/deepl/claude-plugin/blob/main/.mcp.json"
click node_document_translation "https://github.com/deepl/claude-plugin/blob/main/.mcp.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin_manifest,node_mcp_config,node_translation_rules,node_user toneBlue
class node_translation,node_writing_improvement,node_glossary,node_document_translation toneAmber
class node_claude,node_deepl toneIndigo
```

## Components

### Claude plugin

- [Plugin manifest](https://github.com/deepl/claude-plugin/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [MCP configuration](https://github.com/deepl/claude-plugin/blob/main/.mcp.json): `.mcp.json`
- [Translation rules](https://github.com/deepl/claude-plugin/blob/main/skills/translation-rules/SKILL.md): `skills/translation-rules/SKILL.md`

### DeepL capabilities

- [Translation](https://github.com/deepl/claude-plugin/blob/main/.mcp.json): `.mcp.json`
- [Writing improvement](https://github.com/deepl/claude-plugin/blob/main/.mcp.json): `.mcp.json`
- [Glossary access](https://github.com/deepl/claude-plugin/blob/main/.mcp.json): `.mcp.json`
- [Document translation](https://github.com/deepl/claude-plugin/blob/main/.mcp.json): `.mcp.json`

### Other components

- **User**
- **Claude**
- **DeepL**

## Connections

- User → Claude: requests work
- Claude → Plugin manifest: uses plugin
- Claude → Translation rules: uses guidance
- Claude → MCP configuration: connects through
- MCP configuration → Translation: enables
- MCP configuration → Writing improvement: enables
- MCP configuration → Glossary access: enables
- MCP configuration → Document translation: enables
- Translation → DeepL: accesses
- Writing improvement → DeepL: accesses
- Glossary access → DeepL: accesses
- Document translation → DeepL: accesses