Skip to content

Conversation

@ptelang
Copy link
Contributor

@ptelang ptelang commented Sep 19, 2025

This guide documents how to use the meta-mcp server with ToolHive for intelligent tool discovery and unified access to multiple MCP servers. Includes setup instructions along with practical examples and best practices.

🤖 Generated with Claude Code

Description

Related issues/PRs

Screenshots

Merge checklist

Content

  • (N/A) New pages include a frontmatter section with title and description at a minimum
  • (N/A) 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

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

vercel bot commented Sep 19, 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 19, 2025 5:18pm

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 a comprehensive guide for using the meta-mcp server with ToolHive. The meta-mcp server serves as an intelligent intermediary that provides semantic tool discovery and unified access to multiple MCP servers through a single endpoint.

Key changes:

  • Complete documentation for meta-mcp setup and configuration across UI, CLI, and Kubernetes environments
  • Detailed explanation of the meta-mcp workflow and its tool discovery capabilities
  • Practical examples and recommended practices for optimal usage

JAORMX
JAORMX previously approved these changes Sep 19, 2025
aponcedeleonch
aponcedeleonch previously approved these changes Sep 19, 2025
Copy link
Member

@aponcedeleonch aponcedeleonch left a comment

Choose a reason for hiding this comment

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

Left some comments but in general it looks good to me :)

Copy link
Collaborator

@danbarr danbarr left a comment

Choose a reason for hiding this comment

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

A few more questions, and clarification suggestions.

Also it'll need to be run thru prettier...the repo README has the how-to. If you don't want to install npm, there's a dev container you can open in VS Code.

thv client list-registered
```

**Step 3: Add MCP servers to the default group**
Copy link
Collaborator

Choose a reason for hiding this comment

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

Question about usage: A lot of existing users will likely already have their clients registered with the default group. Will this cause an issue if both the meta-mcp and the MCPs "behind" it are available to a client?

From a workflow perspective, would reversing the usage of groups make sense? i.e., put meta-mcp into your default group (or whatever other group you use with your clients), then put the servers it's managing into the meta group and don't connect any clients to that group?

Or if that's not supported (does meta-mcp only look into the default group?), should we guide users to disconnect existing clients from the default group and use it ONLY for the MCPs that meta-mcp is managing?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Meta-mcp server supports either of the two approaches above. Overall, the client should be configured only with the group containing the meta-mcp server.

I think our current approach (meta-mcp in meta group, other servers in default group) works well for existing users with MCP servers in default group. They need to create a new group "meta", run meta-mcp server in meta group, un-configure the clients to use the default group, and configure the clients to use the meta group.

Copy link
Collaborator

Choose a reason for hiding this comment

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

OK, that makes sense, but we'll need to articulate that so they know what's going on.

Copy link
Collaborator

Choose a reason for hiding this comment

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

With the new updates merged in, we can probably roll as-is. I think the only bit we don't explicitly say is that you shouldn't have any single client connected to BOTH the default and meta group?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

It will be good to call that out — clients should not connect to both groups. That will defeat the purpose of meta-mcp server.

This guide documents how to use the meta-mcp server with ToolHive for intelligent tool discovery and unified access to multiple MCP servers. Includes setup instructions along with practical examples and best practices.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@ptelang ptelang merged commit aa253e0 into main Sep 19, 2025
28 checks passed
@ptelang ptelang deleted the add-meta-mcp-doc branch September 19, 2025 18:25
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.

6 participants