diff --git a/src/components/Header.astro b/src/components/Header.astro index ceaf935..6514999 100644 --- a/src/components/Header.astro +++ b/src/components/Header.astro @@ -15,7 +15,7 @@ const { title } = Astro.props; {title === SITE_TITLE && PORTRAIT ? : {title}} ) : ( - ↩ Index + Index )} @@ -25,7 +25,6 @@ const { title } = Astro.props; } a { - text-decoration: none; color: var(--theme-sub-text); &:hover { @@ -36,4 +35,13 @@ const { title } = Astro.props; color: var(--theme-bg); } } + + h1 a { + text-decoration: none; + } + + .back span { + display: inline-block; + margin-inline-end: 1ch; + } diff --git a/src/components/NoteNav.astro b/src/components/NoteNav.astro index b7e7670..e98dda4 100644 --- a/src/components/NoteNav.astro +++ b/src/components/NoteNav.astro @@ -12,14 +12,12 @@ const { prev, next } = Astro.props; @@ -27,7 +25,7 @@ const { prev, next } = Astro.props; diff --git a/src/content/notes/rss-to-mcp.mdx b/src/content/notes/rss-to-mcp.mdx new file mode 100644 index 0000000..d6a6851 --- /dev/null +++ b/src/content/notes/rss-to-mcp.mdx @@ -0,0 +1,65 @@ +--- +title: RSS → MCP +pubDate: 2026-11-14T10:00:00Z +description: How the two standards can work together +slug: rss-to-mcp +published: true +--- + +RSS answers one question: what's new? Agents ask other questions, so they scrape your pages and retell your work in their own words. + +What if every personal site had its own MCP? Instead of just scraping HTML, an agent could ask the site directly and get back what the author actually wrote. RSS pushes what I published. MCP lets you ask about it. + +### The page + +[WebMCP](https://github.com/webmachinelearning/webmcp) is an early proposal for this. A page registers its own tools, and the agent calls them instead of guessing from the DOM. + +```js +await document.modelContext.registerTool({ + name: "about", + description: "Who I am and what this site is", + execute() { + return "Vlad's notes on engineering and life"; + } +}); + +await document.modelContext.registerTool({ + name: "ask", + description: "Ask a question, answered from my notes", + inputSchema: { + type: "object", + properties: { question: { type: "string" } }, + required: ["question"] + }, + execute({ question }) { + return answerFromNotes(question); + } +}); + +await document.modelContext.registerTool({ + name: "subscribe", + description: "Get new notes as they come out", + execute() { + // RSS feed, email newsletter, push notifications, etc. + return "[https://esafev.com/rss.xml](https://esafev.com/rss.xml)"; + } +}); +``` + +### The feed + +RSS and MCP can point to each other. The `subscribe` tool returns my RSS feed, and the feed itself can list my MCP tools. RSS is already extensible through XML namespaces (that's how podcast feeds added chapters and transcripts). + +```xml + + Vlad Esafev + Who I am and what this site is + Ask a question, answered from my notes + +``` + +### The standard + +RSS worked because every feed had the same structure, so one reader could follow any site. Agents don't strictly need that, since they can figure out any tool from its description. But feed readers do. If `ask` meant the same thing everywhere, your reader could add an "Ask" box to every blog you follow. + +The [IndieWeb](https://indieweb.org/) already agreed on Webmention and microformats. Could we agree on a few standard tools, too? diff --git a/src/layouts/NoteLayout.astro b/src/layouts/NoteLayout.astro index 0474f13..2214d01 100644 --- a/src/layouts/NoteLayout.astro +++ b/src/layouts/NoteLayout.astro @@ -40,6 +40,10 @@ const { margin-block: 1em; } + :global(h2, h3) { + margin-block-start: 2em; + } + :global(h2) { font-size: 1.3em; } @@ -70,8 +74,8 @@ const { :global(code) { padding: 0.2rem 0.33rem; margin-inline: -0.125em; - border-radius: 3px; + font-family: inherit; font-size: 0.85em; overflow-wrap: anywhere; @@ -79,14 +83,17 @@ const { } :global(pre) { - --padding-inline: 2rem; - padding: 1rem var(--padding-inline); + --padding-inline: 1.25rem; + margin-block: 1.5em; + padding: 1.25rem var(--padding-inline); padding-inline-end: calc(var(--padding-inline) * 2); overflow: auto hidden; - @media (width >= 37.75em) { - --padding-inline: 1.25rem; - border-radius: 8px; + font-family: inherit; + + @media (width <= 480px) { + --padding-inline: 1em; + padding-block: 1em; } } diff --git a/src/styles/global.css b/src/styles/global.css index 10cfa80..a2050c5 100644 --- a/src/styles/global.css +++ b/src/styles/global.css @@ -41,6 +41,11 @@ background-color: light-dark(var(--color-sky-medium), var(--color-klein-light)); } +code::selection, +code ::selection { + background-color: var(--theme-bg); +} + * { box-sizing: border-box; margin: 0; @@ -67,7 +72,7 @@ body { @media (width <= 480px) { body { max-width: 100%; - padding: 1em; + padding: 3em 1em 1em; } }