Lass KI-Agenten DOCX-Dateien lesen, Korrekturen vornehmen und native Word-Änderungsnachverfolgung anwenden, ohne die Formatierung zu zerstören.
Auch bekannt als dealfluence/adeu, @adeu/mcp-server
- Stars
- 170
- Tools
- 9
- Downloads, 30 Tage
- 3.608
- Neueste Version
- 1.7.1
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- MIT
Was ist Adeu MCP?
Lass KI-Agenten DOCX-Dateien lesen, Korrekturen vornehmen und native Word-Änderungsnachverfolgung anwenden, ohne die Formatierung zu zerstören. Er stellt 9 Tools bereit, etwa read_docx, process_document_batch, accept_all_changes.
Zusammenfassung generiert aus dem README des Projekts
Über Adeu MCP server
Juristen und Entwickler können adeu nutzen, um die Lücke zwischen Markdown-basierten KI-Agenten und Microsoft Word-Dokumenten zu schließen. Der Server fungiert als virtuelles DOM, das DOCX-Dateien in ein token-effizientes CriticMarkup-Format übersetzt. Das ermöglicht es KI-Modellen, die Semantik eines Dokuments zu verstehen, ohne von komplexem XML überwältigt zu werden. So wird sichergestellt, dass die ursprüngliche Formatierung, Schriftarten und Seitenränder unverändert bleiben, wenn ein Agent eine Änderung vorschlägt.
Nutzer können dies über Node.js oder Python MCP server implementieren oder als Plugin für Claude Code verwenden. Es unterstützt verschiedene Umgebungen wie Claude Desktop, Cursor, Windsurf und Gemini CLI. Unter Windows ermöglicht das Python-Backend eine Live-Integration mit einer aktiven Microsoft Word Instanz. Das System bietet spezifische Tools wie read_docx zum Inspizieren von vorhandenem Markup, process_document_batch zum gleichzeitigen Anwenden mehrerer Änderungen und diff_docx_files zum Vergleichen von Dokumentversionen. Die gesamte Core-Verarbeitung findet lokal auf deinem Rechner statt, um die Privatsphäre der Dokumente zu wahren.
Was du damit machen kannst
- 1Dokumente in Batches bearbeitenWeise eine KI an, mehrere Suchen-und-Ersetzen-Operationen durchzuführen und Tabellenzeilen in einem einzigen Durchgang einzufügen.
- 2Dokumentversionen vergleichenLass einen Agenten eine neue Word-Datei erstellen, die die Unterschiede zwischen zwei bestehenden Dokumenten mittels nativer Änderungsnachverfolgung aufzeigt.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Adeu MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAdeu MCP in Claude Code installieren
$ claude mcp add adeu -- npx -y @adeu/mcp-serverAdeu MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"adeu": {
"command": "npx",
"args": [
"-y",
"@adeu/mcp-server"
]
}
}
}Adeu MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"adeu": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@adeu/mcp-server"
]
}
}
}Adeu MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"adeu","type":"stdio","command":"npx","args":["-y","@adeu/mcp-server"]}'Adeu MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"adeu": {
"command": "npx",
"args": [
"-y",
"@adeu/mcp-server"
]
}
}
}Adeu MCP in Codex installieren
$ codex mcp add adeu -- npx -y @adeu/mcp-serverAdeu MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.adeu] command = "npx" args = ["-y", "@adeu/mcp-server"]
Adeu MCP in Gemini CLI installieren
$ gemini mcp add -s user adeu npx -- -y @adeu/mcp-serverAdeu MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"adeu": {
"command": "npx",
"args": [
"-y",
"@adeu/mcp-server"
]
}
}
}Von HostedMCP gestartet am 16. Nov. 2026
Wir haben diesen Befehl für @adeu/mcp-server 1.7.1 in einem isolierten Container ohne Netzwerk und ohne Schlüssel ausgeführt. Er hat geantwortet und 9 Tools gelistet.
Adeu MCP tools 9
Vom Server mit tools/list gelesenread_docxReads a DOCX file. Returns text with inline CriticMarkup for Tracked Changes and Comments: {++inserted++}, {--deleted--}, {==highlighted==}{>>comment<<}. Set clean_view=True for the finalized 'Accepted' text without markup. Modes: - 'full' (default): paginated body content. Use page=N to navigate. - 'outline': heading map only — start here for large docs to plan targeted reads. Defaults to L1-L2 headings; pass outline_max_level=3-6 to see deeper structure. - 'appendix': defined terms, anchors, and cross-reference targets. Consult before editing legal/technical docs to avoid breaking references.
process_document_batchApplies a batch of edits and review actions to a DOCX. All changes evaluate against the ORIGINAL document state — do not chain dependent edits within one batch (e.g. rename X to Y, then modify Y). Apply the rename first, then send a second batch. Each item in `changes` must specify a `type`: 1. 'modify': Search-and-replace. `target_text` must uniquely match — include surrounding context if the phrase is ambiguous. `new_text` supports Markdown: '# Heading 1' through '###### Heading 6', '**bold**', '_italic_', and '\n\n' to split into multiple paragraphs. Empty `new_text` deletes. Do NOT write CriticMarkup tags ({++, {--, {>>) manually — use the `comment` parameter for comments. 2. 'accept' / 'reject': Finalize or revert a tracked change by `target_id` (e.g. 'Chg:12'). 3. 'reply': Reply to a comment by `target_id` (e.g. 'Com:5') with `text`. 4. 'insert_row' / 'delete_row': Table edits. Disk mode only — not supported on Live Word canvas. ID VOLATILITY: 'Chg:N' and 'Com:N' shift between document states. Always call `read_docx` immediately before any accept/reject/reply — do not reuse IDs from earlier in the conversation. `author_name` is used for attribution on all tracked changes and comments, in both disk and Live Word modes.
accept_all_changesAccepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines.
diff_docx_filesCompares two DOCX files and returns a unified diff of their text content. Useful for analyzing differences between versions before editing.
finalize_documentPrepares a document for external distribution or e-signature. This tool combines metadata sanitization, document locking (protection), and markup resolution into a single step. NOTE: PDF export and AES encryption are disabled in this environment.
login_to_adeu_cloudLogs the user into the Adeu Cloud backend. Securely opens a browser window for authentication.
logout_of_adeu_cloudLogs out of the Adeu Cloud backend by clearing the local API key.
search_and_fetch_emailsSearches the user's live email inbox. By default, searches only the Inbox folder. Returns a list of lightweight previews. Call again with `email_id` to fetch the full body and download attachments.
create_email_draftCreates an email draft in the user's native draft box. Provide `reply_to_email_id` to reply, or `subject` and `to_recipients` for a new email.
| read_docx | Reads a DOCX file. Returns text with inline CriticMarkup for Tracked Changes and Comments: {++inserted++}, {--deleted--}, {==highlighted==}{>>comment<<}. Set clean_view=True for the finalized 'Accepted' text without markup. Modes: - 'full' (default): paginated body content. Use page=N to navigate. - 'outline': heading map only — start here for large docs to plan targeted reads. Defaults to L1-L2 headings; pass outline_max_level=3-6 to see deeper structure. - 'appendix': defined terms, anchors, and cross-reference targets. Consult before editing legal/technical docs to avoid breaking references. | |
| process_document_batch | Applies a batch of edits and review actions to a DOCX. All changes evaluate against the ORIGINAL document state — do not chain dependent edits within one batch (e.g. rename X to Y, then modify Y). Apply the rename first, then send a second batch. Each item in `changes` must specify a `type`: 1. 'modify': Search-and-replace. `target_text` must uniquely match — include surrounding context if the phrase is ambiguous. `new_text` supports Markdown: '# Heading 1' through '###### Heading 6', '**bold**', '_italic_', and '\n\n' to split into multiple paragraphs. Empty `new_text` deletes. Do NOT write CriticMarkup tags ({++, {--, {>>) manually — use the `comment` parameter for comments. 2. 'accept' / 'reject': Finalize or revert a tracked change by `target_id` (e.g. 'Chg:12'). 3. 'reply': Reply to a comment by `target_id` (e.g. 'Com:5') with `text`. 4. 'insert_row' / 'delete_row': Table edits. Disk mode only — not supported on Live Word canvas. ID VOLATILITY: 'Chg:N' and 'Com:N' shift between document states. Always call `read_docx` immediately before any accept/reject/reply — do not reuse IDs from earlier in the conversation. `author_name` is used for attribution on all tracked changes and comments, in both disk and Live Word modes. | |
| accept_all_changes | Accepts all tracked changes and removes all comments in a single operation, producing a finalized clean document. Use this when a document review is entirely complete and you want to clear all redlines. | |
| diff_docx_files | Compares two DOCX files and returns a unified diff of their text content. Useful for analyzing differences between versions before editing. | |
| finalize_document | Prepares a document for external distribution or e-signature. This tool combines metadata sanitization, document locking (protection), and markup resolution into a single step. NOTE: PDF export and AES encryption are disabled in this environment. | |
| login_to_adeu_cloud | Logs the user into the Adeu Cloud backend. Securely opens a browser window for authentication. | |
| logout_of_adeu_cloud | Logs out of the Adeu Cloud backend by clearing the local API key. | |
| search_and_fetch_emails | Searches the user's live email inbox. By default, searches only the Inbox folder. Returns a list of lightweight previews. Call again with `email_id` to fetch the full body and download attachments. | |
| create_email_draft | Creates an email draft in the user's native draft box. Provide `reply_to_email_id` to reply, or `subject` and `to_recipients` for a new email. |
Automatisierte Checks
Geluften am 16. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbardealfluence/adeu is public and reachablegithub.com/dealfluence/adeu ↗Bestanden
- Paket nennt dieses Repository als Quelle@adeu/mcp-server names dealfluence/adeu as sourcenpmjs.com/package/@adeu/mcp-server ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @adeu/mcp-servernpmjs.com/package/@adeu/mcp-server/v/1.7.1#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-13github.com/dealfluence/adeu ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @adeu/mcp-serverBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten102 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell9 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenAdeu: Track Changes for the LLM era
LLMs speak Markdown; reviewers speak "Track Changes."
Adeu is a docx ↔ LLM translator: a Model Context Protocol (MCP) server (Python and Node.js implementations) and accompanying SDKs that act as a Virtual DOM for Microsoft Word. It provides a two-way abstraction layer that lets AI agents freely edit document text without destroying the underlying formatting or complex DOCX XML.
While standard libraries like python-docx excel at generating documents from scratch, they fail at non-destructive redlining. Adeu solves this by translating .docx files into a token-efficient Markdown representation. This frees AI agents to focus entirely on document semantics instead of wasting tokens wrestling with OpenXML.
Adeu acts as an intelligent proxy, processing AI edits as safe, atomic transactions:
- Read: Translates the document (from disk or live Word) into LLM-friendly CriticMarkup with a Semantic Appendix of defined terms, cross-references, and likely typos. The agent starts with semantic structure, not raw data.
- Validate: Acts as a strict safety gate. It protects the document's integrity by automatically blocking ambiguous text matches or invalid structural changes before they touch the file.
- Apply: Translates the AI's text edits into native Word Track Changes. Adeu handles the complex XML under the hood, ensuring existing layouts, fonts, and margin comments are perfectly preserved.
Built and maintained by the team at Adeu.
Installation
Adeu can be installed directly into AI assistants as an MCP server, used as a Claude Code plugin or Agent Skill, CLI tool, or used locally as a developer toolchain.
Claude Code (Plugin)
Adeu ships as a Claude Code plugin with a built-in agent skill that teaches Claude how to use the engine effectively. Inside Claude Code:
/plugin marketplace add dealfluence/adeu
/plugin install adeu-redlining@adeu-skills
For best results, also connect either the Node MCP server (npx -y @adeu/mcp-server) or the Python MCP server (uvx --from adeu adeu-server). The plugin works without an MCP server too — it falls back to driving the uvx adeu CLI via Bash.
Other Skills-Compatible Agents (Cursor, Windsurf, VS Code Copilot, etc.)
Adeu's redlining skill follows the open Agent Skills specification and works with any compatible agent:
npx skills add dealfluence/adeu
The skill installs to your agent's skills directory and activates automatically when you ask Claude to redline, edit, or review a .docx file.
Claude Desktop
You can install Adeu directly into Claude Desktop using the official extension package:
- Download the latest
Adeu.mcpbfile from the GitHub Releases page. - Open Claude Desktop and navigate to Settings > Extensions.
- Click Advanced settings and find the Extension Developer section.
- Click Install Extension..., select the downloaded
.mcpbfile, and follow the prompts.
Gemini CLI
Adeu is available as a native Gemini CLI extension. To install:
gemini extensions install https://github.com/dealfluence/adeu
Other MCP Clients (Cursor, Windsurf, etc.)
For IDEs or clients that configure MCP servers via JSON, you can use either the Node.js or Python backend:
Node.js
{
"mcpServers": {
"adeu": {
"command": "npx",
"args": ["-y", "@adeu/mcp-server"]
}
}
}
Python (Required for Live MS Word integration on Windows)
{
"mcpServers": {
"adeu": {
"command": "uvx",
"args": ["--from", "adeu", "adeu-server"]
}
}
}
Agent Workflows
Adeu provides agents with specific tools to read, review, and edit documents safely.
MCP Apps UI: The
read_docxtool supports the MCP Apps UI protocol. When an agent reads a document, Adeu dynamically renders a custom, interactive Markdown view directly inside the chat window.
Recommended Agent Prompt: You can guarantee the best behavioral results by adding this context to your agent's system prompt or project instructions:
Role: Document Specialist Tools:
read_docx: Start withmode="changes"to triage existing tracked changes (Chg:N) and comments (Com:N),search_query(with optionalpage="4-5"range) to locate specific clauses,mode="fields"to inspect form fields (CC:<N>), ormode="outline"followed by bounded page ranges (page="1-8") to read sections without loading the whole file.process_document_batch: Commit & Negotiate Mode. Apply a unified, sequentially evaluated list of changes in one call:type: "modify"for search-and-replace text edits (supports Markdown headings/bold/italic/pipe tables,{#cell:<id>}empty-cell anchors,match_mode="all",regex=True, and single or[{"text": ..., "author": ...}]comments),type: "set_field"for form fields,type: "accept","reject"(with optionalpart), or"reply"for existing markup, andtype: "insert_row"/"delete_row"for table rows. Passmarkup_mode="manual"when inline strikethrough/underline formatting is requested instead of Track Changes.diff_docx_files: Compare two.docxfiles; passoutput_pathandauthor_nameto write the comparison as a tracked-changes.docxin one step.finalize_document: Pre-Send Scrub. Strip metadata, author names, and internal tracking IDs, lock the document (protection_mode="read_only"), and prepare it for distribution.
Live MS Word Integration
If you are running on Windows with Microsoft Word installed, Adeu can act as a real-time copilot, editing the active document right in front of you. This requires running the Python MCP server backend (see Developer Tools below).
Developer Tools (Python & TypeScript)
If you are building a legal-tech application, an automated pipeline, or want to use the local CLI, use our SDKs.
The Python CLI
The Python toolchain is managed via uv.
pip install uv
uv tool install adeu
# Extract clean text for RAG or prompting
adeu extract contract.docx -o contract.md
# Generate a visual diff between two versions
adeu diff v1.docx v2.docx
# Apply edits to the DOCX
adeu apply contract.docx edits.json --author "Review Bot"
# Apply valid edits in salvage mode while reporting failing edits
adeu apply contract.docx edits.json --partial
# High-throughput JSON-Lines daemon
adeu serve
# Scrub author metadata and internal trackers
adeu sanitize redline.docx -o clean.docx --keep-markup --author "My Firm" --report
What the text projection preserves exactly, what it normalizes (lists, styles, synthetic pages), and what stays read-only is specified in docs/FIDELITY.md.
The Python SDK
from adeu import RedlineEngine, ModifyText
from io import BytesIO
with open("MSA.docx", "rb") as f:
stream = BytesIO(f.read())
edit = ModifyText(
target_text="State of New York",
new_text="State of Delaware",
comment="Standardizing governing law."
)
engine = RedlineEngine(stream, author="AI Copilot")
engine.apply_edits([edit])
with open("MSA_Redlined.docx", "wb") as f:
f.write(engine.save_to_stream().getvalue())
The TypeScript SDK
The entire core parsing and diffing engine is also available in pure TypeScript.
import { readFileSync, writeFileSync } from "fs";
import { DocumentObject, RedlineEngine } from "@adeu/core";
const buffer = readFileSync("MSA.docx");
const doc = await DocumentObject.load(buffer);
const engine = new RedlineEngine(doc, "AI Copilot");
engine.process_batch([{
type: "modify",
target_text: "State of New York",
new_text: "State of Delaware",
comment: "Standardizing governing law."
}]);
const outBuffer = await doc.save();
writeFileSync("MSA_Redlined.docx", outBuffer);
See the @adeu/core documentation for full installation and usage details.
n8n Community Node
Adeu ships as an n8n community node (n8n-nodes-adeu) for teams who prefer visual workflow automation over code. It exposes the full engine (extract Markdown, apply tracked changes, generate diffs, and finalize documents) as drop-in nodes that work in both deterministic pipelines and AI Agent tool calls.
# In n8n: Settings → Community Nodes → Install: n8n-nodes-adeu
See the n8n-nodes-adeu README for installation, $fromAI recipes, and example workflows.
LangChain Integration
langchain-adeu is an official integration package that exposes Adeu's local, offline-capable document manipulation tools directly to the LangChain ecosystem.
pip install langchain-adeu
Bundle its capabilities as tools in your agent workflow:
from langchain_adeu import AdeuToolkit
# Instantiate and retrieve all document tools
tools = AdeuToolkit().get_tools()
Refer to the LangChain Workspace Guide for full development instructions and detailed parameters.
Ecosystem & Integrations
Adeu is designed as a Virtual DOM for DOCX. Because we keep the core strictly focused on OpenXML safety, we maintain a dedicated ecosystem/ directory for third-party integrations.
The ecosystem folder hosts policies and guidelines for third-party contributions such as legal validation workflows, CLM sync scripts, and specialized multi-agent architectures.
Are you a vendor or builder? We welcome PRs to the ecosystem folder! Please see our Vendor & Integration Policy to get started.
Adeu Cloud
By default, the core Adeu redlining engine and local file tools are fully open-source and execute entirely on your machine. Adeu never phones home with your local documents (though your chosen LLM provider will naturally process the text the agent reads).
However, for teams requiring end-to-end workflows, you can connect to Adeu Cloud to unlock:
- Email Processing & Fetching: We offer an extended MCP server with secure email thread fetching, document extraction, and automated drafting capabilities to handle contracts directly from your inbox.
Contributing
We welcome contributions from the community! Whether it's fixing bugs, adding capabilities, or improving documentation, please see our Contributing Guide for instructions on setting up the local uv environment, running tests, and understanding the project's strict XML safety guidelines.
License
MIT License. Open source and free to use in commercial applications.
Adeu MCP Fragen
Wie füge ich Adeu MCP zu Claude Code hinzu?
Führe claude mcp add adeu -- npx -y @adeu/mcp-server in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Adeu MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Adeu MCP?
Er stellt 9 Tools bereit, darunter read_docx, process_document_batch, accept_all_changes, diff_docx_files, finalize_document.
Wie bearbeitet Adeu Word-Dokumente, ohne die Formatierung zu verlieren?
Es übersetzt das DOCX in eine Markdown-Repräsentation mit CriticMarkup, validiert die Änderungen und konvertiert sie zurück in native Word-Änderungsnachverfolgung, während Layouts und Kommentare erhalten bleiben.
Sendet Adeu meine Dokumente an einen Server?
Nein, die Core-Engine läuft vollständig auf deinem Rechner und sendet keine Daten nach außen, obwohl dein LLM-Provider den Text verarbeitet, den der Agent liest.
Wie installiere ich Adeu als MCP server?
Du kannst den Node-Server via npx oder den Python-Server via uvx ausführen und ihn in den JSON-Einstellungen deines MCP-Clients konfigurieren.
Kann Adeu zwei DOCX-Dateien vergleichen?
Ja, das Tool diff_docx_files vergleicht zwei Dateien und kann den Vergleich als DOCX mit aktivierter Änderungsnachverfolgung ausgeben.
Unterstützt Adeu das Live-Editieren eines geöffneten Word-Dokuments?
Unter Windows mit installiertem Microsoft Word kann das Python MCP server Backend als Echtzeit-Copilot fungieren, der das aktive Dokument bearbeitet.