Switch quickstarts to toolhive-doc-mcp server#881
Merged
Conversation
Use toolhive-doc-mcp as the example server in the CLI, UI, and K8s quickstarts so new users discover the docs MCP server early. Each quickstart points readers at the hosted toolhive-doc-mcp-remote variant as an alternative to running the container locally. Other fixes captured along the way: - Refresh CLI sample output for thv v0.27 (TYPE column in registry list, qualified io.github.stacklok/<name> names, GROUP and CREATED columns in thv list, JSON log format in thv run). - Replace the K8s remote fetch YAML with an inline MCPServer manifest. - Correct the K8s cleanup selector from app.kubernetes.io/name to app.kubernetes.io/instance; the former never matched any pod. - Drop misleading provenance verification bullet; verification is opt-in via --image-verification. - Tighten future tense and passive voice in prose we touched.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the ToolHive CLI, UI, and Kubernetes Operator quickstarts to use the toolhive-doc-mcp MCP server (and its hosted toolhive-doc-mcp-remote variant) as the primary example instead of the fetch server, aligning the tutorials with a “docs Q&A” onboarding flow.
Changes:
- Swaps quickstart example prompts and explanations from web fetching to ToolHive documentation search (
query_docs/get_chunk). - Adds “remote/hosted” guidance so readers can follow the quickstarts without running a local container (UI/CLI) and highlights
MCPRemoteProxyas a Kubernetes alternative. - Updates Kubernetes quickstart to apply an inline
MCPServermanifest and refreshes related sample outputs/commands.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/toolhive/guides-ui/quickstart.mdx | Updates UI tutorial to install/use ToolHive Docs MCP server and adds a hosted-remote option. |
| docs/toolhive/guides-k8s/quickstart.mdx | Replaces fetch example with toolhive-doc-mcp, inlines an MCPServer manifest, and updates outputs/commands accordingly. |
| docs/toolhive/guides-cli/quickstart.mdx | Updates CLI tutorial to run toolhive-doc-mcp (and remote variant), refreshes example outputs, and adjusts prompt/explanations. |
The PULLS header in thv registry list output is currently empty for every row, so showing it with no values is confusing. Drop the column from the example until upstream populates it.
rdimitrov
approved these changes
May 18, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Updates the CLI, UI, and Kubernetes quickstarts to use the
toolhive-doc-mcpserver as their example MCP server instead offetch. The docs MCP server gives new users a natural on-ramp to discover more about ToolHive through tool calls, and each quickstart links to the hostedtoolhive-doc-mcp-remotevariant as an alternative to running the container locally.While in the files, also corrected drift that had crept in:
thv v0.27.x:thv registry listnow has aTYPEcolumn and namespaced server names (io.github.stacklok/<name>);thv listusesGROUP/CREATEDinstead ofTOOL TYPE/CREATED AT;thv runemits structured JSON logs.mcpserver_fetch.yamlreference in the K8s quickstart with an inlineMCPServermanifest.app.kubernetes.io/name=<instance>never matched a pod (that label is alwaysmcpserver); the correct selector isapp.kubernetes.io/instance=<instance>.--image-verification.Validated the K8s manifest and lifecycle commands against a local kind cluster, and the CLI commands against
thv v0.27.0.Type of change
Related issues/PRs
None.
Submitter checklist
Content and formatting