Освоение управления сервером MCP с помощью инструмента
11 июня 2025 г.В этом блоге мы углубимся в инструмент, небольшой инструмент, который делает управление и развертывание серверов MCP удивительно простыми и безопасными. Повсем инструмент преобразует процесс разработки, интегрируя безопасность контейнеров и автоматизацию конфигурации, независимо от того, используете ли вы курсор, Github Copilot или другие инструменты. Давайте установим и запустим его на совершенно новой виртуальной машине Ubuntu. Теперь начнем!
Предпочитаете смотреть вместо того, чтобы читать? Вот быстрый видеоид
https://youtu.be/0xxatodfuf8?embedable=true
Требования
Инструмент использует контейнеризация, поэтому убедитесь, что у вас установлен Docker или Podman. Здесь я использую Docker. Запустите следующие команды, чтобы установить Docker, если вы еще этого не сделали:
sudo apt update
sudo apt install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker
«Давайте убедитесь, что Docker работает».
docker --version
Настройка поезда инструмента
«Toolhive - это инструмент CLI, который работает на Go. Загрузка двоичного файла или здания из источника позволит вам установить его. Мы создадим его из источника для этой демонстрации.
sudo apt install -y golang git make
git clone https://github.com/stacklok/toolhive.git
cd toolhive
go build ./cmd/thv
sudo cp thv /usr/local/bin/
«Давайте убедитесь, что он был установлен правильно».
thv version
Настройка вашего начального сервера MCP
Давайте теперь используем инструмент для запуска нашего первого сервера MCP. Чтобы он подключился к совместимым клиентам, сначала включите автоматическое открытие.
thv config auto-discovery true
«Теперь запустите сервер MCP Fetch - этот инструмент позволяет LLMS получать контент с веб -сайтов».
thv run fetch
Вы соблюдаете загрузку сервера, а контейнер тянется. Вы можете использовать это для проверки серверов, которые в настоящее время используются:
thv list
Использование: токен GitHub с зашифрованными секретами
«В качестве примера давайте попробуем настроить сервер MCP GitHub, который нуждается в токене аутентификации. Мы будем использовать зашифрованный поставщик инструментов для безопасного обработки секретов.
thv config secrets-provider encrypted
thv secret set github
Вас попросят войти в свой токен GitHub. Давайте запустим сервер GitHub MCP после его завершения:
thv run --secret github,target=GITHUB_PERSONAL_ACCESS_TOKEN github
Изучите реестр
Инструментарий имеет интегрированный реестр MCP. Вы можете просмотреть и найти информацию о серверах, которые доступны здесь:
thv registry list
thv search github
thv registry info github
Настройка пользовательского сервера MCP
Теперь давайте воспользуемся изображением для запуска пользовательского сервера MCP. Как иллюстрация:
thv run --transport sse --name myserver --port 8080 my-mcp-image:latest -- some-args
«Toolhive добавляет метки, строит прокси на случайном порте и надежно завершает ваш контейнер».
Использование менеджеров пакетов для запуска MCP
Схемы протокола, такие как uvx: //, npx: //, и go: // поддерживаются инструментом. Давайте запустим MCP на основе Python прямо из UVX:
thv run uvx://awslabs.core-mcp-server@latest
"Или сервер, построенный с node.js:"
thv run npx://@pulumi/mcp-server@latest
"Или даже местные проекты GO:"
cd my-go-mcp-project
thv run go://.
Персонализировать разрешения
Используя профили JSON, инструмент позволяет настраивать разрешение. Пример:
{
"read": ["/var/run/mcp.sock"],
"network": {
"outbound": {
"allow_host": ["localhost", "google.com"],
"allow_port": [80, 443]
}
}
}
"Сохраните его как profile.json, затем используйте следующее:"
thv run --permission-profile profile.json fetch
Развертывание Kubernetes (предварительный просмотр)
Инструмент теперь позволяет вам использовать оператора для запуска серверов MCP в Kubernetes. Создайте добрый кластер и следуйте инструкциям в репозитории, если вы хотите проверить это локально.
Бонус: ручное зачисление клиентов
«Вы можете вручную зарегистрировать клиента, если автоматическое открытие не функционирует:»
thv config register-client copilot
thv config list-registered-clients
Окончательные замечания
Это всеобъемлющее руководство по использованию инструментов! Как вы можете видеть, это эффективный инструмент для развертывания серверов MCP безопасным и повторяемым образом. Toolhive может помочь вам в запуске пользовательских инструментов или интеграцией с Github Copilot.
Рекомендуемые ресурсы:
- GitHub:https://github.com/stacklok/toolhive
- Документация по мажор инструментов: папка репозитория /DOCS
- Discord: участвовать в сообществе, посетив страницу GitHub Toolhive.
Оригинал