What is Arezzo?
Arezzo is an MCP server that compiles semantic editing operations into correct Google Docs API batchUpdate request sequences — deterministically. It solves the problem of manual UTF-16 offset calculation for AI agents editing documents, handling complex Unicode like emoji and CJK characters.
How to use Arezzo?
Install with pip install arezzo, then run arezzo init to walk through Google OAuth setup and write platform config files. Use the three MCP tools: read_document, edit_document, and validate_operations.
Key features of Arezzo
- Deterministic compilation of semantic edits to API requests.
- UTF-16 index arithmetic with proper surrogate pair handling.
- Address resolution by heading, named range, or bookmark.
- Two-phase compilation for OT-compatible sequencing.
- 23 operation types including text, formatting, tables, and images.
- Zero configuration beyond Google OAuth setup.
Use cases of Arezzo
- AI agents editing Google Docs without manual offset calculation.
- Inserting and formatting text at headings, named ranges, or bookmarks.
- Previewing exact API calls before execution with
validate_operations.
- Editing documents containing emoji, CJK supplementary characters, and other non-BMP Unicode.
コメント