toolhive
stacklok/toolhive加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
图1：ToolHive 项目吉祥物与品牌标识
想象一个场景：你的团队正在用 Claude Code 编写后端 API，同时需要让 AI 访问公司的 Jira 看板、Slack 频道和 GitHub 仓库——每接入一个工具，都意味着要配置一套独立的 MCP 服务器，还要处理认证、网络隔离和权限控制。更棘手的是，不同开发者的电脑上安装的 MCP 服务器版本各异，Security 团队对此一无所知，毫无审计可言。
这就是 ToolHive 试图解决的核心问题。由开源安全公司 Stacklok（其核心产品是 Minder——一个开源软件供应链安全管理平台）于 2024 年创立，ToolHive 的定位是一个企业级的 MCP 服务器全生命周期管理平台，它让组织能够在受控环境下运行、管理和分发 MCP 服务器，同时对所有 AI 工具的调用行为留下完整的审计记录。
Stacklok 的背景值得注意：该公司由 Google Project Zero 和 GitHub 安全团队的前成员创办，在软件供应链安全领域有深厚积累。因此，ToolHive 从一开始就被设计为安全优先——每个 MCP 服务器默认运行在容器隔离环境中，权限被限制到最小必要范围，敏感信息绝不暴露给宿主机本地凭证。
截至 2026 年 6 月，ToolHive 在 GitHub 上拥有 1871 颗星、227 个 Fork，最新版本为 v0.29.3（2026-06-10），保持着活跃的迭代节奏。
ToolHive 采用模块化架构，由四个核心组件构成：
Gateway 是所有入站流量的统一入口，它负责将来自 Claude Desktop、Cursor、VS Code 等 AI 客户端的请求路由到对应的 MCP 服务器，并在此过程中执行一系列中间件（Middleware）策略：
Gateway 还支持虚拟 MCP（Virtual MCP）——将多个真实 MCP 服务器编排成一个统一的虚拟接口，客户端只需要感知一个端点，背后由 Gateway 决定具体路由到哪台服务器。
Registry 是 MCP 服务器的元数据中心，它从官方 MCP 官方注册表同步服务器清单，同时允许组织添加内部私有服务器，并对服务器进行分组、标签管理。Registry 还负责来源验证（Provenance）——为每个服务器的二进制文件签名，确保没有被篡改。
Registry 提供 API 驱动管理接口，可以无缝嵌入现有的 CI/CD 或 IT 管理流程中。
Runtime 负责实际执行 MCP 服务器，支持三种部署模式：
thv）提供一键启停管理thv-operator 通过 Custom Resource Definitions（CRD）在 K8s 集群中管理 MCP 服务器的生命周期，支持多命名空间隔离、Ingress 集成和 Prometheus 指标导出Runtime 遵循工作负载（Workload）模型：每个 MCP 服务器被视为一个工作负载，拥有独立的安全配置文件（最小权限原则）、环境变量隔离和网络策略。
Portal 提供面向最终用户的交互界面，包含两个前端产品：
toolhive-studio）：跨平台桌面客户端toolhive-cloud-ui）：浏览器端云管理界面，面向企业管理员Portal 让非技术用户也能通过「一键安装」使用经过审核的 MCP 服务器，同时让管理员在后台统一管控服务器清单和访问策略。
ToolHive 的核心代码用 Go 1.26 编写，选择 Go 的主要考量是高并发处理能力（Gateway 的中间件链需要同时处理大量 AI 客户端连接）和跨平台编译便利性（一份代码覆盖 Linux/macOS/Windows）。
代码组织上，项目采用了清晰的包分层结构：
| 包名 | 职责 |
|---|---|
pkg/mcp | MCP 协议解析、JSON-RPC 消息处理、工具过滤器 |
pkg/runner | 工作负载生命周期管理、容器启动配置、环境变量注入 |
pkg/authz | Cedar Policy 授权引擎集成 |
pkg/oidc | OIDC/OAuth 身份认证流程 |
pkg/operator | Kubernetes Operator 控制器逻辑 |
pkg/registry | MCP 服务器注册表与元数据存储 |
pkg/server | REST API 服务器（Chi 框架） |
pkg/telemetry | OpenTelemetry 追踪导出 |
pkg/audit | 审计日志持久化 |
pkg/llm | LLM 客户端集成（用于工具过滤） |
pkg/cli | CLI 命令实现（CharmBrlacelet TUI） |
值得关注的第三方依赖包括：
API 服务器使用 go-chi/chi v5 轻量级 HTTP 路由器。数据库迁移使用 pressly/goose v3。
ToolHive 提供四种部署形态，覆盖从个人开发者到大型企业的不同场景：
桌面体验（Desktop）：开发者下载预编译的 thv 二进制（支持 Linux amd64/arm64、macOS amd64/arm64、Windows），配合本地 Docker/Podman 运行 MCP 服务器。安装包经过 Sigstore 签名和 SBOM 清单公示，可通过 gh 命令行一键安装。
Kubernetes Operator：面向平台工程师。通过 Helm Chart 部署 thv-operator，使用 YAML 声明式管理 MCPServer、MCPRegistry 等 CRD，配合 Ingress 和 OIDC 实现生产级 MCP 服务管理。
混合模式（Hybrid）：本地开发者机器 + 云端 K8s 集群的统一视图。企业员工通过 Cloud UI 申请访问已注册的 MCP 服务器，管理员审批后，ToolHive 自动在对应的 K8s 命名空间或开发者本地 Docker 中部署服务器。
Egress Proxy（出站代理）：ToolHive 还提供了一个 Alpine + Squid 的出站代理容器，专门用于安全地转发 MCP 服务器的出站网络请求，防止服务器直接暴露在公网中。
对于 AI 爱好者而言，ToolHive 的上手门槛并不低——它本质上是一个面向平台工程师和企业安全团队的工具，不是开箱即用的 AI 聊天应用。要让它跑起来，至少需要：
因此，它的典型用户画像是：有安全合规要求的企业 AI 平台团队，而非个人 AI 爱好者。
局限性方面：
toolhive-studio 和 toolhive-cloud-ui 仓库，组合成本较高docker-compose.yml，本地多组件快速体验不如想象中简单随着 Claude Code、Cursor、GitHub Copilot 等 AI 编程工具全面支持 MCP 协议，MCP 服务器的管理问题正在从「极客玩具」变成「企业刚需」。2025 年下半年，Anthropic 发布 MCP 官方注册表后，社区涌现了数百个 MCP 服务器，但如何在企业环境安全、可控地管理这些服务器，仍然是一片空白。
ToolHive 填补的正是这个空白。它的竞争对手包括：
ToolHive 的差异化在于：完全开源（Apache 2.0）、安全优先设计（容器隔离 + Cedar Policy + 审计日志）、多环境覆盖（桌面 + K8s + 混合云），以及 Stacklok 团队在供应链安全领域的品牌背书。
从增长趋势看，MCP 协议正在成为 AI 编程工具的事实标准，而 MCP 服务器的企业化管理赛道才刚起步，ToolHive 有潜力成为这个细分领域的标杆项目。