| | | |

ToolHive - simplify and secure MCP servers

Run any Model Context Protocol (MCP) server — securely, instantly, anywhere.

ToolHive is the easiest way to discover, deploy, and manage MCP servers. Launch any MCP server in a locked-down container with a single command. No manual setup, no security headaches, no runtime hassles.

---

Why ToolHive? Instant deployment: Start any MCP server with one command, using Docker or Kubernetes. Secure by default: Every server runs in an isolated container with only the permissions it needs. Secrets are managed securely, never in plaintext. Works everywhere: Use the CLI for local development, or the Kubernetes Operator for production and scale. Seamless integration: ToolHive auto-configures popular clients like GitHub Copilot, Cursor, and more. Quick links 📚 Documentation 🚀 Quickstart guide 💬 Discord

---

Quickstart

To get started, make sure you have Docker or Podman installed.

Install the ToolHive CLI

macOS (or Linux) with Homebrew:

brew tap stacklok/tap
brew install thv

Windows:

winget install stacklok.thv

Or download the latest binary from GitHub releases

Run your first MCP server

1. Enable client auto-discovery (optional):

   thv config auto-discovery true

2. Run the Fetch MCP server:

   thv run fetch

3. List running servers:

   thv list

If you enabled auto-discovery, your supported client can now use the fetch MCP tool to retrieve website content. You might need to restart your client for changes to take effect.

Next steps

ToolHive can run any MCP server from the built-in registry, custom container images, or even build images on the fly from source packages.

FWant to explore more? Run:

thv registry list

This will show additional MCP servers available in the built-in registry that you can run with ToolHive.

For more details, see the Quickstart guide.

---

Contributing

We welcome contributions and feedback from the community!

• 🐛 Report issues
• 🤝 Contributing guide

If you have ideas, suggestions, or want to get involved, check out our contributing guide or open an issue. Join us in making ToolHive even better!

---

License

This project is licensed under the Apache 2.0 License.