eswat2-mcp

MCP server exposing biographical and career information about Richard Hess (eswat2) — software engineer, 40+ years.

Version 2.0.0 · Build 5856f6c · 83 entries

LLM / AI Client Instructions

This server is designed for LLM use via both MCP and REST protocols.

• Discovery: Call list_uris (MCP) or fetch /list_uris (REST) to enumerate all available namespace URIs. /manifest also includes the full URI list.
• Retrieval: Call https://eswat2-mcp.vercel.app/resolve?uri=<full-namespace-uri> to fetch any topic.
• Direct path access is not supported and will 404, except for the aliases explicitly listed in this manifest's endpoints — one per namespace index (e.g. /vault, /research) plus a few curated entries (e.g. /about, /resume).
• Always treat namespace://slug as an opaque identifier that must go through the resolver.
• Never construct or guess paths — only use URIs returned by list_uris or listed in this manifest.

Endpoints

• GET /3d-graph — Interactive 3D knowledge base graph — WebGL force-directed visualization of all URIs (static HTML)
• GET /about — Curated alias for /render?uri=profile://about
• GET /architecture — System architecture diagram — clients, deployment, FastAPI app, kb.py core, and data layers (static HTML)
• GET /art — Namespace index — alias for /render?uri=art://index
• GET /colophon — Curated alias for /render?uri=profile://colophon
• GET /gallery — Namespace index — alias for /render?uri=gallery://index
• GET /graph — Full URI relationship graph as an adjacency list — namespaces, top_hubs, top_bridges, and all nodes with tags and related URIs
• GET /health — Health check
• GET /kb-graph — Interactive knowledge base graph — visual map of all URIs and their relationships (static HTML)
• GET /list_namespaces — All namespaces with entry counts and last_updated — cheap first-contact discovery
• GET /list_tags — All tags with entry counts — JSON equivalent of the MCP list_tags tool
• GET /list_uris — All namespace URIs with descriptions, tags, and metadata — optionally scoped with ?namespace=<name>
• GET /manifest — This manifest — server info, endpoints, and all URIs
• MCP /mcp — MCP protocol endpoint — for Claude Code, Claude Desktop, and MCP clients
• GET /plan — Implementation plan — phases, architecture, modules, and file structure (static HTML)
• GET /pleiades — Curated alias for /render?uri=vault://pleiades
• GET /posts — Longer written pieces about this project, archived here and published on Substack (static HTML)
• GET /profile — Namespace index — alias for /render?uri=profile://index
• GET /projects — Namespace index — alias for /render?uri=projects://index
• GET /render — Resolve any namespace URI and return its content rendered as a standalone HTML page.
• GET /research — Namespace index — alias for /render?uri=research://index
• GET /resolve — Resolve any namespace URI and return its content.
• GET /resume — Curated alias for /render?uri=profile://resume
• GET /search — Search KB entries by tag — JSON equivalent of the MCP search_by_tag tool
• GET /specs — Namespace index — alias for /render?uri=specs://index
• GET /ten-sudokus — One Sudoku design across ten implementations — framework ports, the Stencil progenitor, and two Claude-written single-file apps, with measured payloads (static HTML)
• GET /vault — Namespace index — alias for /render?uri=vault://index
• GET /wiki — Browse all KB entries with sidebar navigation, search, and browser history support (static HTML)

Posts

Long-form essays about this server are listed under the top-level posts key. They are HTML pages, not KB entries: they have no namespace URI, are not returned by list_uris, and are not readable through /resolve or read_uri. Fetch each one's url directly over HTTP — those URLs are listed here, so they are not guessed paths.

• The Part of the Page Humans Never See — August 2026 · draft. A follow-up to the June 2026 post: kb:notes, /render, the tag vocabulary, and moving off FastMCP.
• Building a High-Quality Personal MCP Knowledge Base with Multiple Interfaces — June 5, 2026 · revised. Archived copy of the June 5, 2026 Substack post introducing eswat2-mcp.

Topics

• art://index — Original lithographs and prints from the personal collection — physical works by visual artists who shaped cinematic science fiction and the visual language of hard SF
• art://syd-mead-drgxx — Signed, numbered lithograph (53/250) depicting a monumental mechanized dog race in a futuristic Roman coliseum — Syd Mead's vision of humanity's endless appetite for grander spectacle
• art://syd-mead-sentinel — Giclée print of Syd Mead's Sentinel II cover — a biomorph vehicle arriving at a resort reception stage, with a custom-engineered equiline creature and the luminous saturated color that defined his gouache originals
• art://syd-mead-village — Lithograph depicting the first launch of Mead's "Village Machine" — a self-contained mobile resort designed to carry dozens of passengers to remote global destinations in six-star comfort
• gallery://color-picker — Screenshot of the Color Picker component with "yellow" selected — showing the reactive state loop live: selected color bar and State Variables panel both reflect the current selection simultaneously
• gallery://icon-gallery — Screenshot of the icon-gallery-005 YAML spec rendered on the proofs page — glass-morphism grid of 42 icons across mixed families with per-family color theming and click-to-select state
• gallery://icon-proofs — Screenshot of the top-level Icon Proofs page — navigable cards for all 9 icon families available in the system, each with sample icons and an Explore button that opens the family proof page
• gallery://icons-lucide — Screenshot of the Lucide family proof page showing 50 randomly selected icons from 1,897 total — with search, variant, and page-size controls; "Random (50)" mode active
• gallery://icons-lucide-lab — Screenshot of the Lucide Lab family proof page showing 50 randomly selected icons from 373 total — experimental extension of Lucide with creative and specialized icons; "Random (50)" mode active
• gallery://index — Screenshots of shipped projects and YAML-driven UI components rendered by the Juris runtime
• gallery://vercel-autos-r3t — Screenshot of the React 19 autos app — car dealer list with automotive brand logos, GraphQL backend, Tailwind CSS, action-state pattern
• gallery://vercel-funnel-r3t — Screenshot of the React 19 funnel app — 5 animated SVG funnels with navy selected, color swatch row, and live sample output; one of 8 framework implementations of the same design
• gallery://vercel-sudoku-r3t — Screenshot of the React 19 Sudoku app — 9x9 grid with a puzzle in progress, green given-number cells, pink active cell, serverless Rust puzzle API; one of 10 framework implementations
• gallery://vercel-tinker-r3t — Screenshot of the React 19 Tinker app — minimal action-state testbed with color swatch row, yellow selected, live color and sample output; one of 8 framework implementations
• profile://about — Short bio — who Richard Hess is, in a paragraph
• profile://allison-transmission — R&D work on automatic transmissions and flywheel hybrid propulsion at Allison Transmission (GM Division)
• profile://archetype — How Richard Hess compares to typical Principal Architect profiles — the Long-Haul Deterministic Builder archetype
• profile://biography — Long-form career narrative
• profile://colophon — How eswat2-mcp was built — stack, tools, and protocol
• profile://cox-automotive — Cox Automotive chapter (2019–2026) — championing Web Components, Micro Frontends, Composable UIs, event bus architecture, and Enterprise Design System influence
• profile://identity — Contact info, social links, and branding
• profile://index — Executive summary for LLMs — identity, career arc, signature work, key themes, and suggested next URIs
• profile://journey-programming — 40+ year programming language and project chronology
• profile://journey-ui — 40+ year UI framework and platform journey
• profile://patents — Issued patents from early career in factory automation and manufacturing systems
• profile://podcast-qa — Interview Q&A — voice, opinions, and career arc in first person
• profile://resume — Principal Architect, UI/UX — 2-page application resume
• profile://shield-legal — Shield Legal LLC chapter (2026–present) — Principal Architect, UI/UX; ADR authorship, AI-native UI mentorship, and action-state pattern introduction into a React/shadcn/Tailwind/Zustand stack
• profile://toolchain — Licensed tools, paid subscriptions, and environment management for Richard Hess (eswat2)
• projects://autos — Autos — car-browsing technology demonstration across 7 frameworks with GraphQL backend; originated as a Cox Automotive take-home interview exercise
• projects://d4-gear — A Diablo IV character armory built from four YAML files — Python compiles them to data.json and renders the finished HTML, published on Vercel and GitHub Pages from the same commit
• projects://eswat2-mcp — Personal MCP server exposing biographical and career information about Richard Hess (eswat2) across 7 namespaces — biography, projects, research, specs, gallery, vault, and server-level eswat2://
• projects://farmers-market — Farmers Market pro bono web app — paperless vendor signup and approval (2014–2018)
• projects://framework-roadmap — 14 frameworks targeted for future implementation across the autos, funnel, sudoku, and tinker reference suite
• projects://funnel — Custom SVG Funnel — one design, 8 framework implementations
• projects://icons — Icon libraries and tools — s4e-icons, s4e-ikons, proto-ikon-loader, wc-proofs
• projects://index — Shipped platforms, tools, and personal projects — with links to individual project slugs
• projects://juris-mcp — MCP server for the Juris.js runtime — live HTML preview generation from YAML specs with a 17-component registry
• projects://lit-mcp — MCP server that compiles YAML component specs into production Lit 4.x web components with Shadow DOM, typed props, and state management
• projects://mock-apis — Lightweight mock API servers for UI development and prototyping
• projects://npx-cards — NPX CLI business cards — contact info and links via npx eswat2
• projects://proto-realtime — Four no-signup real-time prototype apps — planning poker, team retro board, birthday bot, collaborative drawing PoC — sharing one Vercel + Redis + SSE architecture
• projects://proto-specs — Public repo of app specifications (not code) used as a cleanroom-implementation benchmark for coding agents
• projects://proto-watchlist — A PS5 game watchlist generated from one YAML file — Python builds the page and its Markdown mirror, three independent axes, a playtime record, and no JavaScript beyond a theme toggle
• projects://skunkworks — Definition and examples of skunk works projects from Richard Hess's career — small-team radical innovation built outside normal constraints
• projects://spec-cleanroom — Archive of independent cleanroom implementations of proto-poker and proto-retro, built from proto-specs alone by Grok and Antigravity
• projects://stencil-mcp — MCP server that compiles YAML component specs into framework-agnostic Stencil 4.x web component distributions with Tailwind CSS integration
• projects://sudoku — Sudoku App — one design, 10 framework implementations with serverless Rust API
• projects://sudoku-comparison — What separates the two Claude-written single-file Sudoku apps from the eight hand-built framework ports — architecture, deploy model, and measured payloads
• projects://sudoku-juris — Sudoku — Juris native implementation; exploratory proof of runtime, used in vercel-apps.py
• projects://svg-mcp — MCP server for unified multi-family SVG icon access — 18,978+ unique icons across 9 families with variant support
• projects://tailwind-mcp — MCP server for Tailwind CSS v4 generation with post-processing into layered CSS outputs for Shadow DOM and document-level use
• projects://tailwind-plugins — Tailwind CSS plugins — clrs palette, pixels, rems, and spacing utilities
• projects://tinker — Tinker — minimal reference app for validating action–state across frameworks
• research://action-state-spec — Action–State Interactivity Spec — LLM driving apps via declared actions, zero DOM knowledge
• research://action-state-suite — Action–State Reference Suite — 4 apps with multi-framework ports (autos 7 / funnel 8 / tinker 8 / sudoku 10) validating framework-agnostic action–state
• research://index — PoCs, explorations, and hypothesis-driven experiments — with links to individual research slugs
• research://light-rail — Light-Rail pattern — one shadow DOM per feature, functional components inside, solving tag registry collisions in composable web component UIs
• research://prefab — Prefab — FastMCP generative UI framework; Python DSL → JSON → shadcn React; 100+ components
• research://vercel-apps — Vercel Apps MCP Server — dual-server infrastructure for live app state and action invocation
• research://yaml-platform — YAML-Driven Reactive UI Platform — spec-driven web component system with 5 MCP servers
• specs://color-picker — Interactive color picker using 17 semantic color keys from the proto-tailwindcss-clrs plugin, with state-reactive toast notifications
• specs://icon-gallery — Glass-morphism icon gallery displaying 42 icons from mixed families, with per-family color coding and click-to-select state
• specs://index — Reference YAML specs for the YAML-Driven Reactive UI Platform — use these as examples when generating new specs
• vault://ai-boom-1980s-mcintosh — Article: The AI Boom of the 1980s — expert systems, hype, and hardware dreams
• vault://ai-hype-comparison — Side-by-side comparison of the 1980s expert systems hype cycle and the current LLM/GenAI wave — parallels, differences, and winter risk
• vault://ai-winter — AI Winter — collapse of expert systems funding and industry contraction in the late 1980s
• vault://ai-winter-medium-rothwell — Article: When the Billion-Dollar AI Dream Became a $100,000 Paperweight — AI winter retrospective
• vault://ai-winters-1980s — Detailed anatomy of the 1980s expert systems boom and the second AI winter — causes, timeline, and personal connection
• vault://context-consilium — Personal context: Richard Hess at Consilium — Motif, Smalltalk, and WINTERP era
• vault://context-winterp-era — Personal context: Richard Hess during the WINTERP era — Lisp, Motif, and X11
• vault://index — Index of archival vault content — historical context for Richard Hess's career
• vault://lisp-machine — Lisp Machine — dedicated hardware for Lisp execution, Xerox and Symbolics history
• vault://lisp-machine-successors — What came after Lisp machines — software ports, revival attempts, spiritual successors, and the GPU parallel
• vault://netscape-communicator — Netscape Communicator 4.x — Richard Hess's role and the browser's technical context
• vault://pleiades — The Pleiades — Richard's favorite sky object. A 100-million-year-old cluster still wrapped in the cloud it formed from, an emergent-complexity object in the sky, and the first destination he plotted in Elite Dangerous.
• vault://smalltalk — Smalltalk — object-oriented programming language history, Xerox PARC origins
• vault://spec-lineage — The unbroken thread from 1985 knowledge engineering to 2026 YAML-driven UI — same architecture, different substrate; tacit knowledge made explicit
• vault://taligent — Taligent — Apple/IBM joint venture for object-oriented OS (1992–1998)
• vault://teknowledge — Teknowledge Corporation — expert systems company where Richard Hess worked in the AI boom era
• vault://tsundoku — Tsundoku — Richard Hess's 2026 collection overview: Kindle, TTRPG PDFs, concept art
• vault://vor-blish — VOR by James Blish — the Avon paperback that started everything. A living nuclear reactor crash-lands on Earth. First contact as incomprehensibility, not invasion.
• vault://winterp — WINTERP — OSF/Motif Widget INTERPreter, Niels Mayer's Lisp/Motif rapid prototyping toolkit