toolhive

<p float="left"> <picture> <img src="docs/images/toolhive-icon-1024.png" alt="ToolHive Studio logo" height="100" align="middle" /> </picture> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-wordmark-white.png"> <img src="docs/images/toolhive-wordmark-black.png" alt="ToolHive wordmark" width="500" align="middle" hspace="20" /> </picture> <picture> <img src="docs/images/toolhive.png" alt="ToolHive mascot" width="125" align="middle"/> </picture> </p> [![Release][release-img]][release] [![Build status][ci-img]][ci] [![Coverage Status][coveralls-img]][coveralls] [![License: Apache 2.0][license-img]][license] [![Star on GitHub][stars-img]][stars] [![Discord][discord-img]][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. <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-diagram-dark.svg"> <img src="docs/images/toolhive-diagram-light.svg" alt="ToolHive diagram" width="800" style="padding: 20px 0" /> </picture> --- <table> <tr> <td width="50%"> ## Why ToolHive? - **Instant deployment:** Start any MCP server with one click or 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 UI and 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. ToolHive is available as a GUI desktop app, CLI, and Kubernetes Operator. <br> </td> <td width="50%" align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-sources-dark.svg"> <img src="docs/images/toolhive-sources-light.svg" alt="ToolHive sources diagram" width="400px" /> </picture> </td> </tr> </table> ## Kubernetes Operator ToolHive includes a Kubernetes Operator for enterprise and production deployments: ### Features - **MCPServer CRD**: Deploy and manage MCP servers as Kubernetes resources - **MCPRegistry CRD** Centralized registry management with automated sync - **Secure isolation**: Container-based server execution with permission profiles - **Protocol proxying**: Stdio servers exposed via HTTP/SSE networking protocols - **Service discovery**: Automatic service creation and DNS integration ### Documentation - [Operator Guide](cmd/thv-operator/README.md) - Complete operator documentation - [MCPRegistry Reference](cmd/thv-operator/REGISTRY.md) - Registry management - [CRD API Reference](docs/operator/crd-api.md) - Auto-generated API documentation - [Deployment Guide](docs/kind/deploying-toolhive-operator.md) - Step-by-step installation - [Examples](examples/operator/) - Sample configurations ## Quick links - 📚 [Documentation](https://docs.stacklok.com/toolhive/) - 🚀 Quickstart guides: - [Desktop app](https://docs.stacklok.com/toolhive/tutorials/quickstart-ui) - [CLI](https://docs.stacklok.com/toolhive/tutorials/quickstart-cli) - [Kubernetes Operator](https://docs.stacklok.com/toolhive/tutorials/quickstart-k8s) - 💬 [Discord](https://discord.gg/stacklok) --- ## Contributing We welcome contributions and feedback from the community! - 🐛 [Report issues](https://github.com/stacklok/toolhive/issues) - 💬 [Join our Discord](https://discord.gg/stacklok) 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! Contribute to the CLI, API, and Kubernetes Operator: - 🤝 [Contributing guide](./CONTRIBUTING.md) - 📖 [Developer guide](./docs/README.md) Contribute to the desktop UI: - 🖥️ [Desktop UI repository](https://github.com/stacklok/toolhive-studio) Contribute to the documentation: - 📚 [Documentation repository](https://github.com/stacklok/docs-website) --- ## License This project is licensed under the [Apache 2.0 License](./LICENSE). <!-- Badge links --> <!-- prettier-ignore-start --> [release-img]: https://img.shields.io/github/v/release/stacklok/toolhive?style=flat&label=Latest%20version [release]: https://github.com/stacklok/toolhive/releases/latest [ci-img]: https://img.shields.io/github/actions/workflow/status/stacklok/toolhive/run-on-main.yml?style=flat&logo=github&label=Build [ci]: https://github.com/stacklok/toolhive/actions/workflows/run-on-main.yml [coveralls-img]: https://coveralls.io/repos/github/stacklok/toolhive/badge.svg?branch=main [coveralls]: https://coveralls.io/github/stacklok/toolhive?branch=main [license-img]: https://img.shields.io/badge/License-Apache2.0-blue.svg?style=flat [license]: https://opensource.org/licenses/Apache-2.0 [stars-img]: https://img.shields.io/github/stars/stacklok/toolhive.svg?style=flat&logo=github&label=Stars [stars]: https://github.com/stacklok/toolhive [discord-img]: https://img.shields.io/discord/1184987096302239844?style=flat&logo=discord&logoColor=white&label=Discord [discord]: https://discord.gg/stacklok <!-- prettier-ignore-end --> <!-- markdownlint-disable-file first-line-heading no-inline-html -->