ToolHive 安装与配置指南

ToolHive 安装与配置指南

toolhive Run and manage MCP servers easily and securely 项目地址: https://gitcode.com/gh_mirrors/to/toolhive

1. 项目基础介绍

ToolHive 是一个轻量级的实用工具，旨在简化 Model Context Protocol (MCP) 服务器部署和管理，保证易用性、一致性和安全性。它通过在容器中运行 MCP 服务器，提供一个受限制的运行环境，仅授予执行所需的最小权限，从而显著减少攻击面，提高用户体验，并强制执行最佳的容器安全实践。

该项目主要使用 Go 语言编写。

2. 项目使用的关键技术和框架

• Docker/Podman: 用于容器化 MCP 服务器，确保一致的运行环境和隔离性。
• 容器编排: 通过 Kubernetes 进行容器编排和管理。
• SSE (Server-Sent Events): 用于客户端和服务端之间的通信。
• ** OCI (Open Container Initiative)**: 遵循 OCI 标准的容器镜像格式，确保兼容性和可靠性。
• 安全存储: 用于管理和存储敏感信息，如 API 令牌和密钥。

3. 准备工作和安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统：macOS 或 Linux
• 容器运行时：Docker 或 Podman
• (可选) 客户端自动发现/配置：支持的客户端包括 VS Code (v1.99.0 或更高版本)、Cursor、Roo Code 等。

安装步骤

步骤 1：下载二进制文件

前往 ToolHive 发布页面 下载适用于您操作系统的最新版本。

步骤 2：使用 Homebrew 安装（macOS）

如果您使用的是 macOS，可以使用 Homebrew 安装 ToolHive：

brew tap stacklok/tap
brew install thv

步骤 3：从源代码构建

克隆项目仓库并使用 Go 语言构建 CLI：

git clone https://github.com/StacklokLabs/toolhive.git
cd toolhive
go build ./cmd/thv

或者，使用 Task：

task build
task install

步骤 4：配置客户端自动发现

启用客户端自动发现，以自动查找支持的客户端并更新其配置：

thv config auto-discovery true

步骤 5：运行您的第一个 MCP 服务器

使用以下命令运行一个示例 MCP 服务器：

thv run fetch

步骤 6：查看运行的 MCP 服务器

列出所有正在运行的 MCP 服务器：

thv list

按照上述步骤操作，您应该能够成功安装和配置 ToolHive，并开始运行 MCP 服务器。如果您在安装过程中遇到任何问题，请查看项目的官方文档或在 GitHub 仓库中提出问题。

toolhive Run and manage MCP servers easily and securely 项目地址: https://gitcode.com/gh_mirrors/to/toolhive