Skip to content

Add MCP server install section on the home page#551

Merged
abernier merged 7 commits into
mainfrom
feat/mcp-server-section
May 20, 2026
Merged

Add MCP server install section on the home page#551
abernier merged 7 commits into
mainfrom
feat/mcp-server-section

Conversation

@abernier

Copy link
Copy Markdown
Member

Summary

Adds a short callout above the libraries grid on docs.pmnd.rs that tells visitors the docs are also reachable via MCP, with a one-line install command for Claude Code and a collapsible JSON snippet for other clients.

  • Endpoint exposed unchanged: https://docs.pmnd.rs/api/mcp (HTTP transport).
  • Server name suggested: pmndrs — covers every pmndrs/* lib, not just one. Users can rename locally.
  • Tool exposed by the server: a single get_page_content returning the markdown of any doc page.

Why on the home

The MCP server is a meta-feature of the docs site itself, not specific to a single library — the libraries grid is the wrong place. Placing it just under the header makes it the first thing devs see and decoupling it from any individual lib avoids the impression it only covers zustand (its current default name in some setups).

Screenshot

(local dev render — please double-check Tailwind classes against the design system; I reused bg-surface-container, border-outline-variant, text-on-surface-variant/50, etc. from the existing library cards.)

Test plan

  • pnpm dev and visit / — section renders above the grid
  • Command line is readable on mobile (the <pre> has overflow-x-auto)
  • <details> toggle reveals the JSON config block
  • Dark/light mode parity

Surfaces the docs.pmnd.rs MCP endpoint so devs can wire it into their AI
coding assistant (Claude Code, Cursor, Windsurf, VS Code, etc.) with a
single command. JSON snippet for non-CLI clients is tucked in a
collapsible `<details>` to keep the section compact.
abernier and others added 2 commits May 20, 2026 11:33
Next.js 16 build refuses to prerender with the vulnerable v5.0.0.
compileMDX from /rsc keeps the same signature in v6 so no code change needed.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Use the shared Gha (TIP alert) and Code components instead of ad-hoc
markup. Primary install is now claude mcp add; JSON config moved behind
a <details>. Link the "MCP-compatible client" wording to the MCP remote
servers spec, and add a trailing note about per-lib llms.txt with the
R3F example.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Covers the home-page changes and folds in the earlier MCP server URL
fix (b06e545) that landed on main without a changeset.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Spell out when a changeset is needed: not for the docs site itself
(Vercel deploys on every main push), but for consumers using
@V3 / Docker image tags who only pull versioned releases.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Icon and background still follow the keyword. Document the new prop in
docs/authoring/gha.mdx and use it on the home page MCP block.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@abernier abernier merged commit e2cf5fe into main May 20, 2026
7 checks passed
@github-actions github-actions Bot mentioned this pull request May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant