ToolHive

A lightweight utility designed to simplify the deployment and management of MCP servers, ensuring ease of use, consistency, and security through containerization.

Art & Literature
Go
View on GitHubVisit Project
GitHub Statistics
617

Stars

53

Forks

Apache License 2.0

License

Updated June 18, 2025

Topics

ai
ai-security
aicodeassistant
golang
kubernetes
mcp
mcp-security
mcp-servers
mcp-tools
security
Documentation

ToolHive Logo ToolHive Logo

Release | CI | License: Apache 2.0 | Star on GitHub | Discord

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.

ToolHive diagram

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


 ToolHive sources diagram

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.

Want 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!

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.