Metadata-Version: 2.5
Name: mcp-win-stdio-word
Version: 0.2.4
Summary: Windows-optimized Model Context Protocol (MCP) server for Word documents: 10 tools for multi-unit margins, multi-column layout, paragraph spacing/indentation, typography, images, and tables.
Author: Mohan Kumar Indala
License-Expression: MIT
Keywords: ai,claude,docx,layout,llm,margins,mcp,typography,windows,word
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Text Processing :: Markup
Requires-Python: >=3.10
Requires-Dist: mcp-win-stdio>=0.2.4
Requires-Dist: mcp>=1.2.0
Requires-Dist: python-docx>=1.1.0
Requires-Dist: pywin32>=306; platform_system == 'Windows'
Description-Content-Type: text/markdown

# mcp-win-stdio-word

Windows-optimized **Model Context Protocol (MCP)** server for Microsoft Word documents (`.docx` and `.doc`): 10 high-precision inspection, layout geometry, typography, and image extraction tools for Claude.

Part of the **`mcp-win-stdio`** Windows-optimized suite.

---

## 🚀 Features (10 Tools)

- **Advanced Page Layout Geometry**: Extracts paper sizes (Letter, A4), exact margins across 4 units (inches, cm, mm, pt), printable area, and section break types (Continuous vs New Page).
- **Multi-Column Analysis**: Detects multi-column layouts (IEEE / academic journal style), column widths, gaps, and separator lines.
- **Paragraph Spacing & Indentation**: Inspects line spacing (single, 1.15, 1.5, double, exact pt), space before/after in pt, first-line indents, hanging indents, and pagination rules (widow/orphan control).
- **Typography & Formatting**: Extracts font families (Times New Roman, Arial, Calibri), font sizes in pt, hex colors (`#002060`), highlights, and paragraph alignments.
- **Image & Visuals Extraction**: Identifies inline vs floating anchor images, placement offsets, dimensions, and header/footer logo positions.
- **Tables & Full Reader**: Extracts tables in Markdown or structured JSON, outlines, and complete document bodies.

---

## 🛠️ Included Tools (10 Tools)

1. `get_document_layout`: Paper sizes, margins in 4 units (in, cm, mm, pt), multi-column layout, printable area.
2. `get_paragraph_spacing_and_indentation`: Line spacing, space before/after (pt), first-line & hanging indents.
3. `get_document_typography`: Font names, sizes (pt), hex colors, highlights, text alignment.
4. `get_document_images`: Images across body, headers, footers, tables with positioning and dimensions.
5. `get_headers_and_footers`: Primary, first-page, and even/odd headers/footers with typography.
6. `get_document_tables`: Extracts all tables in clean Markdown or structured JSON.
7. `get_document_outline`: Heading hierarchy (Title, Heading 1 - 4) with paragraph indices.
8. `get_document_metadata`: Author, title, revision, word count, timestamps.
9. `read_word_document`: Complete body paragraphs, tables, and headers with formatting.
10. `search_word_document`: Keyword and regex search across body, headers, footers, and tables.

---

## 📦 Installation

```powershell
pip install mcp-win-stdio-word
```
*(Installing this package automatically installs `mws` CLI orchestrator)*.

---

## 🚀 One-Command Claude Setup

```powershell
mws setup word
# or:
mws add word
```

### Manual Configuration Example
In `%APPDATA%\Claude\claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "word": {
      "command": "python",
      "args": ["-m", "mcp_win_stdio.word"]
    }
  }
}
```

---

## 📖 CLI Commands & Interactive Guide

```powershell
mws word guide      # Complete tool reference & prompt recipes
mws word doctor     # Verify python-docx and PyWin32 COM readiness
mws word setup      # Configure Claude Desktop / Claude Code
mws word run        # Launch server over stdio
```

---

## 📜 License
MIT License. Copyright (c) 2026 Mohan Kumar Indala.
