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 - -
- -
- Peter Gibbons -

"I did nothing. I did absolutely nothing, and it was everything I thought it could be."

- Peter Gibbons -
- -
- Peter in his zen state -

"I don't like my job, and I don't think I'm gonna go anymore."

- Post-hypnotherapy Peter -
- -
- Peter surprised at computer -

"I have eight different bosses right now."

- The moment of realization -
- -
- ---- - -## Management - -
- -
- Lumbergh at Peter's cubicle -

"Yeahhh, I'm gonna need you to come in on Saturday..."

- Bill Lumbergh -
- -
- The Bobs -

"What would you say... you do here?"

- The Bobs — efficiency experts -
- -
- Management disapproval -

"We're gonna have to go ahead and move you downstairs into Storage B."

- The look of corporate disappointment -
- -
- Lumbergh with cake sign -

"Hello Peter, what's happening?"

- Passive-aggressive celebration -
- -
- ---- - -## The Iconic Scenes - -
- -
- The printer destruction scene -

"PC LOAD LETTER? What the f*** does that mean?!"

- The printer gets what it deserves -
- -
- Milton's stapler -

"I believe you have my stapler..."

- The red Swingline -
- -
- The O-Face -

"O-O-O-OHHHHH!"

- Drew's... moment -
- -
- The cake scene -

"Milton, we're gonna need you to move your desk again..."

- Another office milestone ignored -
- -
- ---- - -## Chotchkie's & The Flair - -
- -
- Stan the manager -

"We need to talk about your flair."

- Stan — the flair enforcer -
- -
- Box of flair -

"You know, the Nazis had pieces of flair they made the Jews wear."

- The official flair collection -
- -
- Joanna's statement -

"There's my flair."

- Joanna's final day at Chotchkie's -
- -
- Chotchkie's logo -

"Sounds like somebody's got a case of the Mondays."

- Where dreams go to die -
- -
- ---- - -## The Supporting Cast - -
- -
- Lawrence -

"Hey Peter, man, check out Channel 9!"

- Lawrence — the neighbor -
- -
- Lawrence on the couch -

"Two chicks at the same time, man."

- Lawrence's dream -
- -
- Nina -

"Uh-oh. Sounds like somebody's got a case of the Mondays."

- Nina — the cheerful coworker -
- -
- Peter, Samir, and Michael Bolton -

"Why should I change? He's the one who sucks."

- The crew at work -
- -
- ---- - -## Initech - -
- -
- Initech building -

"Corporate accounts payable, Nina speaking. Just a moment."

- Initech — where TPS reports are born -
- -
- Peter arriving at Initech -

"Every single day of my life has been worse than the day before it."

- Another day at Initech -
- -
- Empty Initech office -

"I'd like to move us right along to a Peter Gibbons."

- The cubicle farm -
- -
- Milton's stapler recovered -

"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 +
Chotchkie's Bar & Grill
@@ -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..."*