~ knotless Search/
↑↓ move↵ open⇧↵ all results

chadtmiller.com/hud

A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts

0
0
main
Go to filet
Code
README.md

HUD

HUD is a remote MCP server that shows atproto records as interactive UI inside Claude, ChatGPT and any other host of MCP Apps. Give it a handle and it finds the account's PDS and reads the public records there. Name a service's XRPC query (an AppView's feeds, say) and it calls it.

Views draw records and answers. A view is either a bundled one (Bluesky posts and feeds, plyr.fm's playlists and likes, standard.site's blog posts and blogs), an operator's (HUD_APPS, as Grain's galleries are) or one the host's model writes and passes in. With none, HUD builds a card from the collection's lexicon, or a JSON tree. Hosts without MCP Apps get the same data as text.

Everything public works without signing in. Sign in once with an atproto account and Claude can write records for you (a like, a repost, a gallery), click a view's buttons (Like) and read your personal feeds (your timeline) through your own PDS. Signed in, you also get a workspace at /workspace. It's canvases of tiles that you, the people you share them with, and any AI you connect to HUD fill, live.

Running it

cd web && npm ci && cd ..
just serve            # http://localhost:8787, MCP at /mcp

Add http://localhost:8787/mcp to a host that reaches it, or a public deployment's https://<host>/mcp as a custom connector in Claude. Running it has the rest, and every environment variable.

Docs

PageWhat's there
OverviewWhat HUD is, and what isn't built
ToolsThe MCP tools, their inputs and results, query and the writes
ViewsHow a view draws records: joins, summaries, layouts, query joins, the bundled views, the operator's views and trust
App pagesAn app's page, and where an account opens
knotlessknotless's views and how its queries are made
Sign-inOAuth, feed interactions, saved feeds, chats and procedures
WorkspaceCanvases, tiles, agents, music, themes and where canvases live
PlaygroundWriting a view at /playground, beside what it draws
Building an app on HUDHUD's packages for the web, iOS and Android, their registries, versions and releases
Running itCommands, environment variables and the image
MemoryWhat HUD holds in memory and how to measure it
ObservabilityWhat HUD logs, its traces and metrics, and the lines it keeps for its operators
Workspace APIThe workspace's XRPC methods, its event stream and /icon
How it worksIdentity, lexicons, blobs, joins, counts, queries, storage and checks

docs/_style.md says how the docs are written. node harness/docs.mjs (in just lint) checks them.