ToolHive - making MCP servers easy and secure

深受开发者和企业信赖的开源 MCP 平台

随时随地安全、即时地运行任何 MCP 服务。

ToolHive 在隔离容器中运行每个 MCP 服务；配置身份验证源后，会针对每个请求强制执行身份和访问策略，并为平台团队提供在生产环境中部署 MCP 所需的可观测性。

为什么选择 ToolHive？

以下是 ToolHive 的一些常见用例：

开发者。 更安全地运行 MCP 服务，并节省更多（令牌）	平台工程师。 在现有 Kubernetes 基础设施上运行 MCP	企业。 自托管 MCP 服务，并掌控自己的数据
只需单击或运行一条命令，即可将 Claude Code、Cursor、GitHub Copilot 或你偏好的客户端连接到 MCP 服务。 ToolHive 会将每个 MCP 服务封装在隔离容器中，配备最小权限文件（不包含本地凭据），并使用语义工具搜索，将令牌用量最多减少 85%。	杜绝开发者未经管理地使用 MCP，为安全团队提供所需的审计日志和可配置身份强制执行功能。 ToolHive 内置 Kubernetes 运算符，因此你可以声明策略、与 IdP 和可观测性技术栈集成、发送 OTel 跟踪数据等……这一切都可以使用熟悉的工具和模式完成。	大多数 MCP 解决方案都是 SaaS，但你的合规要求不允许 SaaS 提供商处理敏感信息。 ToolHive 则是个例外，它允许你自托管 MCP 注册表、网关等。你可以试用整个平台；准备好扩展规模时，Stacklok 还提供更多功能和专业团队支持！
下载 ToolHive 并开始使用	在文档中了解 Kubernetes 运算符 进一步了解如何在 Kubernetes 上运行 MCP	进一步了解 Stacklok 平台 比较开源 ToolHive 与 Stacklok Enterprise

快速链接

• 📥 下载
• 📚 文档
• 🚀 快速入门指南：
  • 桌面应用
  • CLI
  • Kubernetes 运算符
• 💬 Discord
• 🤝 贡献
• Stacklok Enterprise

---

核心功能

ToolHive 架构：Gateway、Registry Server 和 Runtime，可通过 ToolHive UI 和 CLI 访问

ToolHive 基于模块化架构构建，旨在简化安全的 MCP 服务管理与集成。以下介绍各个主要组件的工作方式。

🔌 Gateway

定义专用端点，让团队能够安全、高效地访问工具。

• 使用确定性工作流引擎，将多个工具编排成虚拟 MCP
• 定义访问策略和网络端点
• 集中管理安全策略、身份验证、授权、审计等
• 与 IdP 集成以实现 SSO（兼容 OIDC/OAuth）
• 自定义和筛选工具及描述，以提升性能并减少令牌用量
• 连接 Claude Desktop、Cursor、VS Code 和 VS Code Server 等本地客户端

📦 Registry Server

整理可信服务目录，让团队能够快速发现和部署服务。

• 与官方 MCP 注册表集成
• 添加自定义 MCP 服务
• 根据角色或使用场景对服务分组
• 通过 API 驱动的界面管理注册表（或将其嵌入现有工作流，实现无缝集成和治理）
• 通过内置安全控制验证来源并为服务签名
• 预设配置和权限，带来流畅的用户体验

⚙️ Runtime

在本地或 Kubernetes 集群中部署、运行和管理 MCP 服务，并提供安全防护。

• 通过 Kubernetes 在云端部署 MCP 服务，实现企业级扩展能力
• 通过 Docker 或 Podman 在本地运行 MCP 服务
• 安全代理远程 MCP 服务，实现统一管理
• 使用 Kubernetes Operator 管理服务群组和资源
• 利用 OpenTelemetry 和 Prometheus 进行监控和审计日志记录

💻 界面

选择最适合工作流的界面。

• 使用 ToolHive UI，享受跨平台桌面体验
• 使用 ToolHive CLI 执行终端工作流和自动化任务
• 发现、配置和运行 MCP 服务
• 自动将受管理的 MCP 服务连接到兼容的 AI 客户端

各组件如何协同工作

1. 管理员在 Registry 中整理和组织 MCP 服务，并配置访问权限和策略。
2. 用户通过 ToolHive UI 或 CLI 发现、配置和运行 MCP 服务，由 ToolHive 编排部署和访问。
3. Runtime 在本地和云端环境中安全部署和管理 MCP 服务，与现有 SDLC 工作流无缝集成、导出分析数据，并实施精细化访问控制。
4. Gateway 处理所有入站流量，保护上下文和凭据，优化工具选择，并应用组织策略。

---

灵活部署

桌面体验

个人开发者可以通过桌面 UI 或 CLI 在几分钟内开始使用，之后也可以在企业环境中应用相同的概念。

主要功能：

• 从容器镜像运行任意 MCP 服务，或使用常见包管理器动态构建服务
• 使用简单的本地工具管理加密密钥并控制网络隔离
• 使用官方 MCP Inspector 等内置工具测试和验证 MCP 服务
• 使用 MCP Optimizer 优化令牌用量和工具执行

通过 UI 开始使用： 快速入门、操作指南
通过 CLI 开始使用： 快速入门、操作指南、命令参考

MCP 指南：了解如何使用 ToolHive 运行常见的 MCP 服务

Kubernetes Operator

团队和组织可通过熟悉的 Kubernetes 工作流，集中管理 MCP 服务和注册表。

主要功能：

• 为 MCP 服务、注册表和其他 ToolHive 组件提供自定义资源定义
• 通过基于容器的隔离和多命名空间支持，实现安全执行
• 自动创建和发现服务，并集成 ingress 以实现安全访问
• 企业级安全性和可观测性：OIDC/OAuth SSO、安全令牌交换、审计日志记录、OpenTelemetry 和 Prometheus 指标
• 混合注册表服务：从上游注册表整理内容、动态注册本地 MCP 服务，或代理可信的远程服务

快速开始：快速入门、操作指南、CRD 参考、示例清单

混合部署

ToolHive 为团队和企业提供完整解决方案，支持在所有环境中运行 MCP 服务：开发者计算机上、Kubernetes 集群内，或由可信 SaaS 提供商托管的外部环境中。

最终用户和开发者可通过 ToolHive UI 或 CLI 管理获批的 MCP 服务，既可使用引导式桌面工作流，也可通过基于终端的自动化和测试进行管理。

企业团队还可以利用 ToolHive，将 MCP 服务集成到自定义内部工具、智能体工作流或基于聊天的界面中，并使用相同的运行时和访问控制。

---

参与贡献

我们欢迎社区贡献和反馈！

• 🐛 报告问题
• 💬 加入我们的 Discord

如果你有想法或建议，或者希望参与其中，请查看我们的贡献指南或提交问题。加入我们，一起让 ToolHive 变得更好！

为 CLI、API 和 Kubernetes Operator（本仓库）贡献： 🤝 贡献指南 📖 开发者指南 📐 架构文档 为 UI、注册表和文档贡献： 💻 桌面 UI 仓库 📦 ToolHive 注册表服务仓库 🛠️ ToolHive 内置注册表 📚 文档仓库

---

许可证

本项目采用 Apache 2.0 许可证 授权。