103 lines
2.9 KiB
Text
103 lines
2.9 KiB
Text
|
---
|
||
|
|
title: mcwaddams
|
||
|
|
description: MCP server for Microsoft Office document processing. Named for Milton Waddams, who was relocated to the basement with boxes of legacy documents.
|
||
|
|
template: splash
|
||
|
|
hero:
|
||
|
|
tagline: "I was told there would be document extraction."
|
||
|
|
image:
|
||
|
|
file: ../../assets/stapler.svg
|
||
|
|
actions:
|
||
|
|
- text: Get Started
|
||
|
|
link: /installation/
|
||
|
|
icon: right-arrow
|
||
|
|
variant: primary
|
||
|
|
- text: View on GitHub
|
||
|
|
link: https://github.com/ryanmalloy/mcwaddams
|
||
|
|
icon: external
|
||
|
|
variant: minimal
|
||
|
|
---
|
||
|
|
|
||
|
|
import { Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
|
||
|
|
|
||
|
|
## The Situation
|
||
|
|
|
||
|
|
You have Office documents. Lots of them. Some are modern `.docx` files. Others are `.doc` files from 1997 that predate Unicode. Your AI agent needs to read them, but native PDF-to-text tools just stare blankly.
|
||
|
|
|
||
|
|
**mcwaddams** handles what nobody else wants to touch.
|
||
|
|
|
||
|
|
<CardGrid stagger>
|
||
|
|
<Card title="20 Tools" icon="document">
|
||
|
|
Extract text, tables, images, metadata. Analyze structure. Convert to Markdown. Index for on-demand fetching.
|
||
|
|
</Card>
|
||
|
|
<Card title="Legacy Support" icon="puzzle">
|
||
|
|
`.doc`, `.xls`, `.ppt` — the formats everyone forgot about until they need them. We didn't forget.
|
||
|
|
</Card>
|
||
|
|
<Card title="Smart Fallbacks" icon="setting">
|
||
|
|
When python-docx chokes, mammoth steps in. When openpyxl fails, pandas takes over. No silent failures.
|
||
|
|
</Card>
|
||
|
|
<Card title="MCP Resources" icon="open-book">
|
||
|
|
Index once, fetch chapters/sheets/slides on demand. Keep your context window manageable.
|
||
|
|
</Card>
|
||
|
|
</CardGrid>
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Quick Install
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# With uvx (recommended)
|
||
|
|
uvx mcwaddams
|
||
|
|
|
||
|
|
# Add to Claude Code
|
||
|
|
claude mcp add mcwaddams "uvx mcwaddams"
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## Documentation Structure
|
||
|
|
|
||
|
|
This documentation follows the [Diátaxis framework](https://diataxis.fr/):
|
||
|
|
|
||
|
|
<CardGrid>
|
||
|
|
<LinkCard
|
||
|
|
title="Tutorials"
|
||
|
|
description="Learn by doing. Step-by-step guides for common workflows."
|
||
|
|
href="/tutorials/first-extraction/"
|
||
|
|
/>
|
||
|
|
<LinkCard
|
||
|
|
title="How-To Guides"
|
||
|
|
description="Solve specific problems. Task-oriented recipes."
|
||
|
|
href="/how-to/extract-tables/"
|
||
|
|
/>
|
||
|
|
<LinkCard
|
||
|
|
title="Reference"
|
||
|
|
description="Look up tool parameters and return values."
|
||
|
|
href="/reference/tools/"
|
||
|
|
/>
|
||
|
|
<LinkCard
|
||
|
|
title="Explanation"
|
||
|
|
description="Understand the architecture and design decisions."
|
||
|
|
href="/explanation/architecture/"
|
||
|
|
/>
|
||
|
|
</CardGrid>
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## TPS Reports
|
||
|
|
|
||
|
|
> *"Did you get the memo about the TPS reports?"*
|
||
|
|
|
||
|
|
We take testing seriously. Check out our [Test Dashboard](/tps/dashboard/) for live results, or browse the [Torture Tests](/tps/torture/) where we threw 301 random Office documents at mcwaddams.
|
||
|
|
|
||
|
|
**Result:** 99.3% success rate. The 2 failures were empty/corrupt files.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
<div style="text-align: center; margin-top: 3rem; opacity: 0.6;">
|
||
|
|
<small>
|
||
|
|
Named for Milton Waddams, who was relocated to the basement with the legacy documents.
|
||
|
|
<br/>
|
||
|
|
<em>"I could set the building on fire..."</em>
|
||
|
|
</small>
|
||
|
|
</div>
|