adeu

Adeu：LLM 時代の変更履歴

LLM は Markdown を使い、レビュー担当者は「変更履歴」を使います。

Adeu はdocx ↔ LLM トランスレーターです。Microsoft Word の仮想 DOMとして機能する、Model Context Protocol（MCP）サーバー（Python および Node.js 実装）と、それに付属する SDK を提供します。双方向の抽象化レイヤーにより、AI エージェントは基盤となる書式や複雑な DOCX XML を損なうことなく、ドキュメントのテキストを自由に編集できます。

python-docx のような標準ライブラリは、ドキュメントを一から生成するのには優れていますが、元の内容を損なわない変更履歴の作成には対応できません。Adeu は、.docx ファイルをトークン効率の高い Markdown 表現に変換することで、この問題を解決します。これにより、AI エージェントは OpenXML の処理にトークンを費やすことなく、ドキュメントの意味内容に集中できます。

Adeu はインテリジェントプロキシとして機能し、AI による編集を安全なアトミックトランザクションとして処理します。

1. 読み取り： ドキュメントを（ディスクまたは稼働中の Word から）LLM 向けの CriticMarkup に変換し、定義済みの用語、相互参照、誤記の可能性をまとめたセマンティック付録を付けます。エージェントは生データではなく、意味構造をもとに作業を始めます。
2. 検証： 厳格な安全ゲートとして機能します。ファイルに変更が加わる前に、曖昧なテキストの一致や無効な構造変更を自動的にブロックし、ドキュメントの整合性を守ります。
3. 適用： AI によるテキスト編集を、Word ネイティブの変更履歴に変換します。Adeu が複雑な XML を内部で処理し、既存のレイアウト、フォント、コメントが完全に保持されるようにします。

Adeu のチームが開発・保守しています。

---

インストール

Adeu は MCP サーバーとして AI アシスタントに直接インストールできるほか、Claude Code プラグインまたはエージェントスキル、CLI ツールとして利用したり、開発者向けツールチェーンとしてローカルで利用したりできます。

Claude Code（プラグイン）

Adeu は、エンジンを効果的に使う方法を Claude に教えるエージェントスキルを組み込んだ Claude Code プラグインとして提供されています。Claude Code 内で次を実行してください。

/plugin marketplace add dealfluence/adeu
/plugin install adeu-redlining@adeu-skills

最良の結果を得るには、Node MCP サーバー（npx -y @adeu/mcp-server）または Python MCP サーバー（uvx --from adeu adeu-server）も接続してください。MCP サーバーがなくてもプラグインは動作し、代わりに Bash 経由で uvx adeu CLI を実行します。

その他のスキル対応エージェント（Cursor、Windsurf、VS Code Copilot など）

Adeu の変更履歴作成スキルは、オープンな Agent Skills 仕様に準拠しており、互換性のあるすべてのエージェントで利用できます。

npx skills add dealfluence/adeu

このスキルはエージェントのスキルディレクトリにインストールされ、.docx ファイルの変更履歴の作成、編集、レビューを Claude に依頼すると自動的に有効になります。

Claude Desktop

公式の拡張機能パッケージを使って、Adeu を Claude Desktop に直接インストールできます。

1. GitHub Releases ページから、最新の Adeu.mcpb ファイルをダウンロードします。
2. Claude Desktop を開き、Settings > Extensions に移動します。
3. Advanced settings をクリックし、「Extension Developer」セクションを開きます。
4. Install Extension... をクリックして、ダウンロードした .mcpb ファイルを選択し、画面の指示に従います。

Gemini CLI

Adeu はネイティブの Gemini CLI 拡張機能として利用できます。インストール方法：

gemini extensions install https://github.com/dealfluence/adeu

その他の MCP クライアント（Cursor、Windsurf など）

JSON 経由で MCP サーバーを設定する IDE やクライアントでは、Node.js または Python のバックエンドを使用できます。

Node.js

{
  "mcpServers": {
    "adeu": {
      "command": "npx",
      "args": ["-y", "@adeu/mcp-server"]
    }
  }
}

Python（Windows での MS Word ライブ連携に必須）

{
  "mcpServers": {
    "adeu": {
      "command": "uvx",
      "args": ["--from", "adeu", "adeu-server"]
    }
  }
}

Smithery

Smithery パッケージマネージャーを使用して Adeu をインストールするには：

npx -y @smithery/cli install adeu --client claude

---

エージェントのワークフロー

Adeu は、ドキュメントを安全に読み取り、レビューし、編集するための専用ツールをエージェントに提供します。

MCP Apps UI： read_docx ツールは MCP Apps UI プロトコルに対応しています。エージェントがドキュメントを読み取ると、Adeu はチャットウィンドウ内にカスタムのインタラクティブな Markdown 表示を動的にレンダリングします。

推奨するエージェントプロンプト： エージェントのシステムプロンプトまたはプロジェクトの指示にこのコンテキストを追加すると、最良の動作結果を得られます。

役割： ドキュメントスペシャリスト ツール：

• read_docx(clean_view=True)：最終的な「クリーン」版のテキストを読み取り、コンテキストを把握します。ドキュメント全体を読まずに特定の条項を探すには、search_query と page のフィルターを使用します。
• process_document_batch：確定と交渉のモード。 変更の統一リストを適用します。特定の検索置換テキスト編集には type: "modify" を使用します（match_mode="all" と regex=True による一括更新に対応）。また、ID を指定して既存の変更履歴やコメントを管理するには、type: "accept"、"reject"、または "reply" を使用します。
• finalize_document：送信前のクリーニング。 危険なメタデータ、作成者名、内部追跡 ID を削除し、ドキュメントをロックし（protection_mode="read_only"）、配布できる状態にします。

MS Word ライブ連携

Microsoft Word がインストールされた Windows 上で実行している場合、Adeu はリアルタイムのコパイロットとして、目の前にあるアクティブなドキュメントを編集できます。この機能を利用するには、Python MCP サーバーのバックエンドを実行する必要があります（下記の開発者向けツールを参照）。

---

開発者向けツール（Python と TypeScript）

リーガルテックアプリケーションや自動化パイプラインを構築する場合、またはローカル CLI を使用する場合は、SDK をご利用ください。

Python CLI

Python ツールチェーンは 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

テキストへの投影で厳密に保持される内容、正規化される内容（リスト、スタイル、合成ページ）、および読み取り専用のままとなる内容については、docs/FIDELITY.md に記載されています。

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())

TypeScript SDK

コアの解析および差分生成エンジン全体は、純粋な 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);

インストール方法と使用方法の詳細については、@adeu/core のドキュメントを参照してください。

n8n コミュニティノード

Adeu は、コードよりも視覚的なワークフロー自動化を好むチーム向けに、n8n コミュニティノード（n8n-nodes-adeu）として提供されています。エンジンの全機能（Markdown の抽出、変更履歴の適用、差分の生成、ドキュメントの最終処理）を、決定論的なパイプラインと AI エージェントのツール呼び出しの両方で使用できる、すぐに組み込めるノードとして公開します。

# In n8n: Settings → Community Nodes → Install: n8n-nodes-adeu

インストール方法、$fromAI の使用例、ワークフローの例については、n8n-nodes-adeu README を参照してください。

---

LangChain 連携

langchain-adeu は、Adeu のローカルでオフライン利用可能なドキュメント操作ツールを LangChain エコシステムに直接公開する、公式の連携パッケージです。

pip install langchain-adeu

エージェントのワークフローでツールとして機能をまとめて利用できます：

from langchain_adeu import AdeuToolkit

# Instantiate and retrieve all document tools
tools = AdeuToolkit().get_tools()

開発手順の詳細とパラメーターについては、LangChain ワークスペースガイドを参照してください。

---

エコシステムとインテグレーション

Adeu は DOCX 用の仮想 DOM として設計されています。コアを OpenXML の安全性に厳密に特化させているため、サードパーティとのインテグレーション専用の ecosystem/ ディレクトリを用意しています。

エコシステムフォルダーでは、法的検証ワークフロー、CLM 同期スクリプト、専門的なマルチエージェントアーキテクチャなど、サードパーティからの貢献に関するポリシーやガイドラインを公開しています。

ベンダーまたは開発者の方ですか？ エコシステムフォルダーへの PR を歓迎します！始めるには、ベンダーおよびインテグレーションポリシーをご覧ください。

---

Adeu Cloud

デフォルトでは、Adeu のコア差分表示エンジンとローカルファイルツールは完全なオープンソースで、すべてお使いのマシン上で実行されます。Adeu がローカルのドキュメントを外部に送信することはありません（ただし、選択した LLM プロバイダーは、エージェントが読み取るテキストを当然処理します）。

エンドツーエンドのワークフローが必要なチームは、Adeu Cloud に接続することで、以下の機能を利用できます。

• メール処理と取得： メールのスレッドを安全に取得し、ドキュメントを抽出して、自動で文書を作成する機能を備えた拡張 MCP サーバーを提供します。受信トレイから契約書を直接処理できます。

Adeu Cloud の詳細はこちら。

---

貢献

コミュニティからの貢献を歓迎します！バグの修正、機能の追加、ドキュメントの改善など、貢献方法については貢献ガイドをご覧ください。ローカルの uv 環境の設定方法、テストの実行方法、プロジェクトが定める厳格な XML 安全性ガイドラインについて説明しています。

---

ライセンス

MIT ライセンスです。オープンソースで、商用アプリケーションでも無料で使用できます。