diff --git a/.dockerignore b/.dockerignore
deleted file mode 100644
index ede3a55..0000000
--- a/.dockerignore
+++ /dev/null
@@ -1,7 +0,0 @@
-node_modules
-dist
-.astro
-.git
-.env
-.env.*
-!.env.example
diff --git a/.env.example b/.env.example
deleted file mode 100644
index 004823d..0000000
--- a/.env.example
+++ /dev/null
@@ -1,2 +0,0 @@
-COMPOSE_PROJECT_NAME=mcwaddams-site
-DOMAIN=mcwaddams.mcp.website
diff --git a/Caddyfile b/Caddyfile
deleted file mode 100644
index cec1847..0000000
--- a/Caddyfile
+++ /dev/null
@@ -1,24 +0,0 @@
-:8080 {
- root * /srv
- file_server
-
- handle /health {
- respond "OK" 200
- }
-
- # SPA-style fallback for clean URLs
- try_files {path} {path}/ {path}.html /index.html
-
- # Cache static assets aggressively
- @static path *.css *.js *.svg *.png *.webp *.jpg *.jpeg *.gif *.ico *.woff *.woff2
- header @static Cache-Control "public, max-age=31536000, immutable"
-
- # Security headers
- header {
- X-Content-Type-Options "nosniff"
- X-Frame-Options "DENY"
- Referrer-Policy "strict-origin-when-cross-origin"
- }
-
- encode gzip zstd
-}
diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index 7698e4f..0000000
--- a/Dockerfile
+++ /dev/null
@@ -1,21 +0,0 @@
-# Stage 1: Build the Astro/Starlight site
-FROM node:22-alpine AS build
-
-WORKDIR /app
-
-COPY package.json package-lock.json* ./
-RUN npm ci
-
-COPY . .
-RUN npm run build
-
-# Stage 2: Serve static files with Caddy
-FROM caddy:2-alpine
-
-COPY --from=build /app/dist /srv
-COPY Caddyfile /etc/caddy/Caddyfile
-
-EXPOSE 8080
-
-HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
- CMD wget -qO- http://127.0.0.1:8080/health || exit 1
diff --git a/Makefile b/Makefile
deleted file mode 100644
index 8c1a521..0000000
--- a/Makefile
+++ /dev/null
@@ -1,28 +0,0 @@
-.PHONY: build up down restart logs status clean
-
-build:
- docker compose build
-
-up: build
- docker compose up -d
- @echo "Waiting for container to start..."
- @sleep 3
- docker compose logs --tail=20
-
-down:
- docker compose down
-
-restart:
- docker compose down
- docker compose up -d --build
- @sleep 3
- docker compose logs --tail=20
-
-logs:
- docker compose logs -f
-
-status:
- docker compose ps
-
-clean:
- docker compose down --rmi local --volumes
diff --git a/astro.config.mjs b/astro.config.mjs
index 2594d73..3f7b3b2 100644
--- a/astro.config.mjs
+++ b/astro.config.mjs
@@ -99,7 +99,6 @@ export default defineConfig({
{
label: 'Community',
items: [
- { label: 'The Gallery', slug: 'community/gallery', badge: { text: 'New', variant: 'success' } },
{ label: 'Feedback', slug: 'community/feedback' },
{ label: 'Flair Leaderboard', slug: 'community/leaderboard' },
{ label: 'Credits', slug: 'community/credits' },
diff --git a/docker-compose.yml b/docker-compose.yml
deleted file mode 100644
index 9b8fccb..0000000
--- a/docker-compose.yml
+++ /dev/null
@@ -1,19 +0,0 @@
-services:
- site:
- build: .
- restart: unless-stopped
- networks:
- - caddy
- labels:
- caddy: ${DOMAIN}
- caddy.reverse_proxy: "{{upstreams 8080}}"
- healthcheck:
- test: ["CMD", "wget", "-qO-", "http://127.0.0.1:8080/health"]
- interval: 30s
- timeout: 3s
- start_period: 5s
- retries: 3
-
-networks:
- caddy:
- external: true
diff --git a/public/Initech.webp b/public/Initech.webp
deleted file mode 100644
index ab2a941..0000000
Binary files a/public/Initech.webp and /dev/null differ
diff --git a/public/box-of-flair.webp b/public/box-of-flair.webp
deleted file mode 100644
index 7dbedf8..0000000
Binary files a/public/box-of-flair.webp and /dev/null differ
diff --git a/public/flair/cinema.svg b/public/flair/cinema.svg
deleted file mode 100644
index 290ae3a..0000000
--- a/public/flair/cinema.svg
+++ /dev/null
@@ -1,37 +0,0 @@
-
diff --git a/public/peter-initech-sign.webp b/public/peter-initech-sign.webp
deleted file mode 100644
index d5a196a..0000000
Binary files a/public/peter-initech-sign.webp and /dev/null differ
diff --git a/public/peter-zen.webp b/public/peter-zen.webp
deleted file mode 100644
index c620564..0000000
Binary files a/public/peter-zen.webp and /dev/null differ
diff --git a/src/assets/Initech.webp b/src/assets/Initech.webp
deleted file mode 100644
index ab2a941..0000000
Binary files a/src/assets/Initech.webp and /dev/null differ
diff --git a/src/assets/box-of-flair.webp b/src/assets/box-of-flair.webp
deleted file mode 100644
index 7dbedf8..0000000
Binary files a/src/assets/box-of-flair.webp and /dev/null differ
diff --git a/src/assets/peter-initech-sign.webp b/src/assets/peter-initech-sign.webp
deleted file mode 100644
index d5a196a..0000000
Binary files a/src/assets/peter-initech-sign.webp and /dev/null differ
diff --git a/src/assets/peter-zen.webp b/src/assets/peter-zen.webp
deleted file mode 100644
index c620564..0000000
Binary files a/src/assets/peter-zen.webp and /dev/null differ
diff --git a/src/content/docs/backstory.mdx b/src/content/docs/backstory.mdx
index 179dfb8..06d1f53 100644
--- a/src/content/docs/backstory.mdx
+++ b/src/content/docs/backstory.mdx
@@ -5,6 +5,8 @@ description: How Milton Waddams became the patron saint of legacy document proce
import { Aside } from '@astrojs/starlight/components';
+# The Backstory
+
> *"I was told I could listen to the radio at a reasonable volume from nine to eleven..."*
## The Relocation
diff --git a/src/content/docs/community/credits.mdx b/src/content/docs/community/credits.mdx
index 8857561..04490fa 100644
--- a/src/content/docs/community/credits.mdx
+++ b/src/content/docs/community/credits.mdx
@@ -5,6 +5,8 @@ description: The open source projects and cultural references that make mcwaddam
import { Aside, Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
+# Credits & Attributions
+
> *"It's not just about me and my dream of doing nothing."*
mcwaddams stands on the shoulders of giants — both technical and cinematic.
@@ -131,8 +133,6 @@ For creating Office Space and giving the tech industry a shared vocabulary for d
The hero image — featuring THE actual film slate and red Swingline from production — is courtesy of [Mike Judge on X](https://x.com/MikeJudge).
-Additional Office Space screenshots and character images sourced from the [Office Space Wiki](https://officespace.fandom.com/wiki/Office_Space_Wiki). Initech logo from the [Initech wiki page](https://officespace.fandom.com/wiki/Initech). Box of Flair merchandise image from the [Office Space Box of Flair wiki page](https://officespace.fandom.com/wiki/Office_Space_Box_of_Flair).
-
### Swingline
For actually manufacturing a red stapler after the movie came out. Sometimes life imitates art. (Fun fact: the prop department painted a black stapler red because Swingline didn't make that color in 1999.)
diff --git a/src/content/docs/community/feedback.mdx b/src/content/docs/community/feedback.mdx
index 26b1348..9cf49e4 100644
--- a/src/content/docs/community/feedback.mdx
+++ b/src/content/docs/community/feedback.mdx
@@ -5,6 +5,8 @@ description: Found a bug? Have an idea? We want to hear it.
import { Aside, Card, CardGrid, LinkCard } from '@astrojs/starlight/components';
+# Feedback
+
> *"Excuse me, I believe you have my bug report..."*
We want to hear from you — bugs, feature requests, or just letting us know what works.
diff --git a/src/content/docs/community/gallery.mdx b/src/content/docs/community/gallery.mdx
deleted file mode 100644
index 3a9f035..0000000
--- a/src/content/docs/community/gallery.mdx
+++ /dev/null
@@ -1,212 +0,0 @@
----
-title: The Gallery
-description: A tribute to the film that inspired it all.
----
-
-import { Aside, Card, CardGrid } from '@astrojs/starlight/components';
-
-> *"I'd say in a given week I probably only do about fifteen minutes of real, actual work."*
-
-Welcome to the mcwaddams gallery — a loving tribute to Office Space (1999), the film that understands corporate life better than any management consultant ever could.
-
----
-
-## The Initech Crew
-
-
-
-
-
-
"I did nothing. I did absolutely nothing, and it was everything I thought it could be."
- Peter Gibbons
-
-
-
-
-
"I don't like my job, and I don't think I'm gonna go anymore."
- Post-hypnotherapy Peter
-
-
-
-
-
"I have eight different bosses right now."
- The moment of realization
-
-
-
-
----
-
-## Management
-
-
-
-
-
-
"Yeahhh, I'm gonna need you to come in on Saturday..."
- Bill Lumbergh
-
-
-
-
-
"What would you say... you do here?"
- The Bobs — efficiency experts
-
-
-
-
-
"We're gonna have to go ahead and move you downstairs into Storage B."
- The look of corporate disappointment
-
-
-
-
-
"Hello Peter, what's happening?"
- Passive-aggressive celebration
-
-
-
-
----
-
-## The Iconic Scenes
-
-
-
-
-
-
"PC LOAD LETTER? What the f*** does that mean?!"
- The printer gets what it deserves
-
-
-
-
-
"I believe you have my stapler..."
- The red Swingline
-
-
-
-
-
"O-O-O-OHHHHH!"
- Drew's... moment
-
-
-
-
-
"Milton, we're gonna need you to move your desk again..."
- Another office milestone ignored
-
-
-
-
----
-
-## Chotchkie's & The Flair
-
-
-
-
-
-
"We need to talk about your flair."
- Stan — the flair enforcer
-
-
-
-
-
"You know, the Nazis had pieces of flair they made the Jews wear."
- The official flair collection
-
-
-
-
-
"There's my flair."
- Joanna's final day at Chotchkie's
-
-
-
-
-
"Sounds like somebody's got a case of the Mondays."
- Where dreams go to die
-
-
-
-
----
-
-## The Supporting Cast
-
-
-
-
-
-
"Hey Peter, man, check out Channel 9!"
- Lawrence — the neighbor
-
-
-
-
-
"Two chicks at the same time, man."
- Lawrence's dream
-
-
-
-
-
"Uh-oh. Sounds like somebody's got a case of the Mondays."
- Nina — the cheerful coworker
-
-
-
-
-
"Why should I change? He's the one who sucks."
- The crew at work
-
-
-
-
----
-
-## Initech
-
-
-
-
-
-
"Corporate accounts payable, Nina speaking. Just a moment."
- Initech — where TPS reports are born
-
-
-
-
-
"Every single day of my life has been worse than the day before it."
- Another day at Initech
-
-
-
-
-
"I'd like to move us right along to a Peter Gibbons."
- The cubicle farm
-
-
-
-
-
"I could set the building on fire..."
- The stapler survived
-
-
-
-
----
-
-
-
-
-
-*"I don't like my job, and I don't think I'm gonna go anymore."*
-
-
-
-— Peter Gibbons, speaking for all of us
-
-
diff --git a/src/content/docs/community/leaderboard.mdx b/src/content/docs/community/leaderboard.mdx
index 1f7fa4a..39fd86a 100644
--- a/src/content/docs/community/leaderboard.mdx
+++ b/src/content/docs/community/leaderboard.mdx
@@ -5,6 +5,8 @@ description: Who's got the most pieces of documentation flair?
import { Aside, Card, CardGrid } from '@astrojs/starlight/components';
+# Flair Leaderboard
+
@@ -17,49 +19,46 @@ We don't require 37 pieces of flair like Brian. Just the minimum — but we enco
## Your Collection
-Click the **flair counter** in the bottom-right corner of any page to see your collection. Badges are earned by spending 15+ seconds reading each page.
+Click the **flair counter** in the bottom-right corner of any page to see your collection. Badges are earned by spending 3+ seconds reading each page.
-## Available Flair (13 Badges)
+## Available Flair (12 Badges)
-
- Start your mcwaddams journey (homepage)
+
+ Visit the homepage
- Learn about Milton and the legacy documents
+ Read the backstory
- Successfully install mcwaddams
+ Complete installation
- Complete the quick start guide
+ Finish quick start
- Read the complete tools reference
+ Browse tools reference
- Understand the architecture
+ Study architecture
-
- Check the test dashboard
+
+ Check test dashboard
-
- Witness the torture test results
+
+ Survive torture tests
-
- Find the credits and attributions
+
+ View leaderboard
-
- Complete your first extraction tutorial
+
+ Read the credits
-
- Master table extraction
+
+ Learn legacy formats
-
- Discover the flair leaderboard
-
-
- Explore the Office Space gallery
+
+ Use hosted MCP
@@ -67,7 +66,7 @@ Click the **flair counter** in the bottom-right corner of any page to see your c
## The Goal
-Collect all 13 pieces of flair. Brian from accounting has 37, but we only ask for the minimum.
+Collect all 12 pieces of flair. Brian from accounting has 37, but we only ask for the minimum.
-## Uploading Documents
+## Using with URLs
-The hosted server cannot access files on your local machine. Instead, you have two options:
-
-### Option 1: URL Reference
-
-If your document is already hosted online:
+The hosted server can process documents from URLs directly:
```python
# Extract text from a public document
@@ -97,77 +95,7 @@ result = await session.call_tool("extract_text", {
})
```
-### Option 2: Base64 Upload
-
-For local files, encode them as base64 and pass via `file_content`:
-
-
-
- ```python
- import base64
- from pathlib import Path
-
- # Read and encode your document
- doc_path = Path("my-report.docx")
- file_content = base64.b64encode(doc_path.read_bytes()).decode("utf-8")
-
- # Call the tool with file_content
- result = await session.call_tool("extract_text", {
- "file_path": "my-report.docx", # Used for extension detection
- "file_content": file_content
- })
- ```
-
-
- ```javascript
- import { readFileSync } from 'fs';
-
- // Read and encode your document
- const docBuffer = readFileSync('my-report.docx');
- const fileContent = docBuffer.toString('base64');
-
- // Call the tool with file_content
- const result = await session.callTool("extract_text", {
- file_path: "my-report.docx", // Used for extension detection
- file_content: fileContent
- });
- ```
-
-
- ```bash
- # Encode document to base64
- FILE_CONTENT=$(base64 -w 0 my-report.docx)
-
- # Call via HTTP (simplified example)
- curl -X POST https://mcwaddams.l.supported.systems/mcp \
- -H "Content-Type: application/json" \
- -d "{
- \"method\": \"tools/call\",
- \"params\": {
- \"name\": \"extract_text\",
- \"arguments\": {
- \"file_path\": \"my-report.docx\",
- \"file_content\": \"$FILE_CONTENT\"
- }
- }
- }"
- ```
-
-
-
-
-
-### All Tools Support Upload
-
-Every tool that accepts `file_path` also accepts `file_content`:
-
-- `extract_text` - Extract text with base64 upload
-- `extract_images` - Extract images with base64 upload
-- `convert_to_markdown` - Convert Word docs to Markdown
-- `analyze_excel_data` - Analyze uploaded spreadsheets
-- And all other document tools...
+This is particularly useful for processing documents already hosted online.
## Self-Hosting
@@ -183,16 +111,10 @@ services:
- MCP_TRANSPORT=streamable-http
- MCP_HOST=0.0.0.0
- MCP_PORT=8000
- # Enable local file access (disabled by default for security)
- # - MCP_ALLOW_LOCAL_FILES=true
ports:
- "8000:8000"
```
-
-
### With Caddy Reverse Proxy
Clone the repo and use our docker-compose with caddy-docker-proxy labels:
diff --git a/src/content/docs/how-to/pagination.mdx b/src/content/docs/how-to/pagination.mdx
index 4ca46ac..16bd995 100644
--- a/src/content/docs/how-to/pagination.mdx
+++ b/src/content/docs/how-to/pagination.mdx
@@ -5,6 +5,8 @@ description: Work with documents that exceed token limits.
import { Aside } from '@astrojs/starlight/components';
+# Handle Pagination
+
> *"Yeah, I'm gonna need you to go ahead and come in on Saturday for page 2..."*
Documents over 25,000 tokens are automatically paginated. Use cursors to fetch subsequent pages.
diff --git a/src/content/docs/how-to/url-processing.mdx b/src/content/docs/how-to/url-processing.mdx
index 5acda88..9e1a65c 100644
--- a/src/content/docs/how-to/url-processing.mdx
+++ b/src/content/docs/how-to/url-processing.mdx
@@ -5,6 +5,8 @@ description: Extract documents directly from HTTP/HTTPS URLs.
import { Aside } from '@astrojs/starlight/components';
+# Process URLs
+
> *"We fixed the glitch... by caching the download."*
All tools accept HTTP/HTTPS URLs directly. Files are cached for 1 hour.
diff --git a/src/content/docs/installation.mdx b/src/content/docs/installation.mdx
index df9266c..afdd7da 100644
--- a/src/content/docs/installation.mdx
+++ b/src/content/docs/installation.mdx
@@ -5,6 +5,8 @@ description: Get mcwaddams up and running in under a minute.
import { Tabs, TabItem, Aside, Steps } from '@astrojs/starlight/components';
+# Installation
+
> *"PC Load Letter? What the f*** does that mean?"*
Don't worry. This is simpler than fixing the printer.
diff --git a/src/content/docs/quickstart.mdx b/src/content/docs/quickstart.mdx
index 39232e5..6118774 100644
--- a/src/content/docs/quickstart.mdx
+++ b/src/content/docs/quickstart.mdx
@@ -5,6 +5,8 @@ description: Extract your first document in 60 seconds.
import { Aside, Steps, Code } from '@astrojs/starlight/components';
+# Quick Start
+
> *"I'll be honest with you, I love his music. I do. I'm a Michael Bolton fan."*
Let's get you extracting documents faster than you can say "TPS report cover sheet."
diff --git a/src/content/docs/reference/excel-tools.mdx b/src/content/docs/reference/excel-tools.mdx
index 39583b3..8924352 100644
--- a/src/content/docs/reference/excel-tools.mdx
+++ b/src/content/docs/reference/excel-tools.mdx
@@ -5,6 +5,8 @@ description: Specialized tools for Excel spreadsheet processing.
import { Aside } from '@astrojs/starlight/components';
+# Excel Tools
+
These 3 tools are specialized for `.xlsx`, `.xls`, and `.csv` files.
## analyze_excel_data
diff --git a/src/content/docs/reference/formats.mdx b/src/content/docs/reference/formats.mdx
index 806ee9b..9a2b75e 100644
--- a/src/content/docs/reference/formats.mdx
+++ b/src/content/docs/reference/formats.mdx
@@ -5,6 +5,8 @@ description: Complete list of supported Office document formats.
import { Aside } from '@astrojs/starlight/components';
+# Format Support
+
mcwaddams supports all major Microsoft Office formats, both modern and legacy.
## Modern Formats (2007+)
diff --git a/src/content/docs/reference/resources.mdx b/src/content/docs/reference/resources.mdx
index 68d85f8..ea31aed 100644
--- a/src/content/docs/reference/resources.mdx
+++ b/src/content/docs/reference/resources.mdx
@@ -5,6 +5,8 @@ description: Resource URIs for on-demand document access.
import { Aside } from '@astrojs/starlight/components';
+# MCP Resources
+
After indexing a document, access content via MCP resource URIs.
## Resource URI Schemes
diff --git a/src/content/docs/reference/tools.mdx b/src/content/docs/reference/tools.mdx
index bb4d1f2..cb56302 100644
--- a/src/content/docs/reference/tools.mdx
+++ b/src/content/docs/reference/tools.mdx
@@ -5,6 +5,8 @@ description: Complete reference for all 20 mcwaddams MCP tools.
import { Aside, Badge, Tabs, TabItem, Card, CardGrid } from '@astrojs/starlight/components';
+# All Tools Reference
+
> *"I'm going to need you to go ahead and read the documentation..."*
mcwaddams provides **20 tools** organized into three categories. Each tool follows the same pattern: pass a file path (local or URL), get structured data back.
diff --git a/src/content/docs/reference/universal-tools.mdx b/src/content/docs/reference/universal-tools.mdx
index e425cf5..8ce700c 100644
--- a/src/content/docs/reference/universal-tools.mdx
+++ b/src/content/docs/reference/universal-tools.mdx
@@ -5,6 +5,8 @@ description: Tools that work across all Office document formats.
import { Aside } from '@astrojs/starlight/components';
+# Universal Tools
+
These 7 tools work with all supported formats: `.docx`, `.doc`, `.xlsx`, `.xls`, `.pptx`, `.ppt`, `.csv`.
## extract_text
diff --git a/src/content/docs/reference/word-tools.mdx b/src/content/docs/reference/word-tools.mdx
index 8cc286e..beb7cbc 100644
--- a/src/content/docs/reference/word-tools.mdx
+++ b/src/content/docs/reference/word-tools.mdx
@@ -5,6 +5,8 @@ description: Specialized tools for Word document processing.
import { Aside } from '@astrojs/starlight/components';
+# Word Tools
+
These 10 tools are specialized for `.docx` and `.doc` files.
## convert_to_markdown
diff --git a/src/content/docs/tps/coverage.mdx b/src/content/docs/tps/coverage.mdx
index e599b3d..0f144c6 100644
--- a/src/content/docs/tps/coverage.mdx
+++ b/src/content/docs/tps/coverage.mdx
@@ -5,6 +5,8 @@ description: Test coverage philosophy and metrics.
import { Aside } from '@astrojs/starlight/components';
+# Coverage Report
+
> *"Looks like you've been missing a lot of work lately."*
> *"I wouldn't say I've been missing it, Bob."*
diff --git a/src/content/docs/tps/dashboard.mdx b/src/content/docs/tps/dashboard.mdx
index 544c1f5..0c54c82 100644
--- a/src/content/docs/tps/dashboard.mdx
+++ b/src/content/docs/tps/dashboard.mdx
@@ -5,6 +5,8 @@ description: "Did you get the memo about the TPS reports?"
import { Aside, Badge, Card, CardGrid } from '@astrojs/starlight/components';
+# TPS Reports: Test Dashboard
+
> *"Yeah, I'm gonna need you to go ahead and come in on Saturday..."*