toolhive

<p float="left"> <picture> <img src="docs/images/toolhive-icon-1024.png" alt="ToolHive 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-mascot.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 includes everything you need to use MCP servers in production. Rather than build or combine components yourself, use ToolHive's Registry Server, Runtime, Gateway, and Portal to get up and running quickly and safely. ToolHive keeps you in control of your MCP estate. Integrate with popular clients in seconds and deploy pre-vetted MCP servers in locked-down containers with a single click or command. ToolHive is available as a desktop app, web app, CLI, and Kubernetes operator. <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. <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> ## Quick links - 📥 [Downloads](https://toolhive.dev/download/) - 📚 [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](#contributing) --- ## Core capabilities **ToolHive architecture: Gateway, Registry Server, Runtime, and Portal** ToolHive is built on a [modular architecture](./docs/arch/README.md) to streamline secure MCP server management and integration. Here's how the main components work. ### 🔌 Gateway Define dedicated endpoints from which your teams can securely and efficiently access tools. - Orchestrate multiple tools into a virtual MCP with a deterministic workflow engine - Define access policies and network endpoints - Centralize control of security policy, authentication, authorization, auditing, etc. - Integrate with your IdP for SSO (OIDC/OAuth compatible) - Customize and filter tools and descriptions to improve performance and reduce token usage - Connect with local clients like Claude Desktop, Cursor, and VS Code ### 📦 [Registry Server](https://github.com/stacklok/toolhive-registry-server) Curate a catalog of trusted servers your teams can quickly discover and deploy. - Integrate with the official MCP registry - Add custom MCP servers - Group servers based on role or use case - Manage your registry with an API-driven interface (or embed in existing workflows for seamless integration and governance) - Verify provenance and sign servers with built-in security controls - Preset configurations and permissions for a frictionless user experience ### ⚙️ Runtime Deploy, run, and manage MCP servers locally or in a Kubernetes cluster with security guardrails. - Deploy MCP servers in the cloud via Kubernetes for enterprise scalability - Run MCP servers locally via Docker or Podman - Proxy remote MCP servers securely for unified management - Kubernetes Operator for fleet and resource management - Leverage OpenTelemetry and Prometheus for monitoring and audit logging ### 💻 Portal Simplify MCP adoption for developers and knowledge workers across your enterprise - Cross-platform [desktop app](https://github.com/stacklok/toolhive-studio) and browser-based [cloud UI](https://github.com/stacklok/toolhive-cloud-ui) - Make it easy for admins to curate MCP servers and tools - Automate server di