Skip to content

Conversation

@danbarr
Copy link
Collaborator

@danbarr danbarr commented Sep 4, 2025

Description

Adds an initial batch of detailed usage guides for popular MCP servers. For each server, instructions for using it with the ToolHive UI, CLI, and K8s Operator are included, along with sample prompts and usage guidance.

These guides cover a wide range of MCP and ToolHive capabilities including secrets management, network isolation, filesystem access, etc.

Included is a custom Docusaurus plugin that runs thv registry info for each server to dynamically populate the metadata at site build time, with supporting scripts to make thv available in the Vercel build environment and dev container.

Related issues/PRs

N/A

Screenshots

Sidebar:
image

Inline metadata (in collapsible panel):
image

Merge checklist

Content

  • New pages include a frontmatter section with title and description at a minimum
  • Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
  • (N/A) Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviews

  • Content has been reviewed for technical accuracy
  • Content has been reviewed for spelling, grammar, and style

Signed-off-by: Dan Barr [email protected]

Copilot AI review requested due to automatic review settings September 4, 2025 19:54
@vercel
Copy link

vercel bot commented Sep 4, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
docs-website Ready Ready Preview Comment Sep 4, 2025 8:09pm

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds comprehensive usage guides for popular MCP servers, demonstrating how to configure and use them with ToolHive. It introduces a custom Docusaurus plugin that dynamically fetches MCP server metadata at build time, ensuring documentation stays current.

Key changes:

  • Added detailed usage guides for 8 MCP servers (Playwright, OSV, Kubernetes, GitHub, Filesystem, Fetch, Context7)
  • Created a custom Docusaurus plugin to dynamically fetch server metadata via thv registry info
  • Added supporting infrastructure for Vercel builds and development environments

Reviewed Changes

Copilot reviewed 36 out of 41 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
docs/toolhive/guides-mcp/*.mdx New MCP server usage guides with UI/CLI/K8s instructions
plugins/mcp-metadata-plugin/ Custom Docusaurus plugin for dynamic metadata generation
src/components/MCPMetadata/ React component for displaying server metadata
scripts/install-thv.sh Script to install ToolHive CLI in build environments
vercel.json Updated with schema and custom build commands
Various config files Added plugin registration, global components, and updated dependencies

@danbarr danbarr merged commit 5d8f8f1 into main Sep 4, 2025
6 checks passed
@danbarr danbarr deleted the mcp-usage-guides branch September 4, 2025 21:36
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.

3 participants