ToolHive: как безопаснее запускать MCP-серверы для Claude, Codex и Cursor

Если FastMCP отвечает на вопрос «как написать MCP server на Python», ToolHive отвечает на другой: как запускать сторонние MCP servers так, чтобы они не получали весь host автоматически.

Для локальных container-based MCP понадобится Docker, Podman или совместимый runtime. Remote MCP через ToolHive можно proxy'ровать без локального container.

Windows

winget install stacklok.thv

thv version

macOS / Homebrew

brew tap stacklok/tap
brew install thv

thv version

Linux

Для Linux можно скачать готовый binary из GitHub Releases, распаковать и положить thv в PATH.

В ToolHive есть built-in profiles none и network, а для production лучше создавать собственные минимальные profiles.

Пример custom profile

{
  "name": "docs-reader",
  "read": [
    "D:\\Projects\\docs:/data"
  ],
  "write": [],
  "network": {
    "outbound": {
      "insecure_allow_all": false,
      "allow_host": [
        "api.example.com"
      ],
      "allow_port": [
        443
      ]
    }
  },
  "privileged": false
}

thv run my-server \
  --permission-profile ./docs-reader.json

Current ToolHive поддерживает три основных secret providers: encrypted local storage, 1Password и environment variables.

thv secret setup

В RunConfig reference выглядит концептуально так:

{
  "secrets": [
    "github-token,target=GITHUB_PERSONAL_ACCESS_TOKEN"
  ]
}

thv registry list
thv registry info <server-name>
thv run <server-name>

Registry metadata может описывать container/remote endpoint, transport, required env vars, permissions и другие параметры. Для организации можно поднять собственный registry server.

thv export my-server ./my-server.json

thv run --from-config ./my-server.json

Export включает runtime parameters, permissions и middleware configuration, но secret values не должны попадать в portable RunConfig — там остаются только secret references.

Экспорт в Kubernetes resource

thv export my-server ./my-server.yaml --format k8s

ToolHive Operator использует CRD для MCP servers, registries, groups, authorization, telemetry и virtual MCP aggregation. Platform team может централизовать OIDC, policies и observability.

Практическая связка выглядит так: вы пишете internal tool через FastMCP, собираете image, запускаете его через ToolHive с read-only mount и allowlist network, затем подключаете к Claude/Codex.

Главная ценность — не контейнер сам по себе. Это комбинация isolation, permission profiles, secrets, registry, proxy и client configuration. В результате MCP server можно описать как воспроизводимый workload, а не как непрозрачный процесс с доступом ко всему пользовательскому окружению.

Для домашнего AI-сервера или рабочего ПК разумный старт: ToolHive CLI/Desktop, минимальный custom permission profile, отдельные scoped secrets и private local access.