eswat2 MCP Server

The personal knowledge base for Richard Hess (eswat2), exposed as an MCP server. Covers 40+ years of software engineering history: biography, shipped projects, research explorations, YAML UI specs, gallery screenshots, and archival vault content.

Stack: Python · FastMCP · FastAPI · uvicorn

Port: 9100 (local) · Deployed on Vercel

MCP Tools

Discovery is layered — start small, drill down:

list_namespaces — compact summary of all namespaces with entry counts; cheapest first-contact call
list_uris(namespace?) — full URI registry, optionally scoped to one namespace (e.g. namespace="projects")
read_uri — retrieve content for any namespace URI
search_by_tag — find entries by tag across all namespaces
list_tags — list all tags with entry counts
get_graph — full URI relationship graph with top hubs and bridges

Namespaces

Namespace	Content
`profile://`	Identity, biography, journeys, resume
`projects://`	Shipped platforms, tools, and personal projects
`research://`	PoCs, explorations, and hypothesis-driven experiments
`specs://`	Reference YAML specs for the YAML-Driven Reactive UI Platform
`gallery://`	Screenshots of shipped projects and YAML-driven UI components
`vault://`	Archival historical context: AI winter, Lisp machines, Teknowledge, WINTERP, Taligent
`eswat2://`	Server-level resources — `eswat2://manifest` (server info, endpoints, tools)

Client Integration

All clients require the server running on localhost:9100 (or Vercel URL for remote access).

Client	Transport	Config
Claude Code	HTTP native	`claude mcp add eswat2 --transport http http://localhost:9100/mcp`
Claude Desktop	stdio via mcp-remote	`{ "command": "npx", "args": ["mcp-remote", "http://localhost:9100/mcp"] }`
Perplexity / stdio-only	stdio via mcp-remote	`npx mcp-remote http://localhost:9100/mcp`