Инструмент проверки подключения облачного MCP Server

Это облачный MCP Server, использующий только Streamable HTTP. Публичная точка входа:

https://你的域名/mcp

Вышестоящая система может обнаружить и вызвать mcp_connection_test; после вызова всегда возвращается MCP连接成功. Инструмент не вызывает модели и не требует API Key.

Структура развертывания

上游 MCP 客户端 -> HTTPS 443 -> Caddy -> MCP Server 8000

Caddy автоматически получает и продлевает HTTPS-сертификаты, а порт 8000 MCP Server не открыт напрямую в публичную сеть.

Related MCP server: MCP MCPO Demo Server

1. Подготовка сервера и домена

1. Установите на облачном сервере Docker Engine и плагин Docker Compose.

2. Подготовьте домен, например mcp.example.com.

3. Добавьте для этого домена A-запись, указывающую на публичный IP облачного сервера.

4. Разрешите TCP-порты 80 и 443 в группе безопасности облачного провайдера и в брандмауэре сервера.

В MCP_DOMAIN указывайте только домен, без https:// и без пути.

2. Загрузка проекта

Выполните на локальном Mac, заменив SERVER_USER и SERVER_IP на реальные значения. Здесь явно исключаются локальные .env и виртуальное окружение, чтобы не загружать на сервер старые API Key или посторонние файлы:

rsync -av \
  --exclude='.env' \
  --exclude='.venv' \
  --exclude='__pycache__' \
  "/Users/clarence/Desktop/项目/兴先达/MCP测试/" \
  SERVER_USER@SERVER_IP:~/mcp-connection-test/

Войдите на сервер:

ssh SERVER_USER@SERVER_IP
cd ~/mcp-connection-test

3. Указание домена и запуск

cp deploy.env.example deploy.env

Отредактируйте deploy.env:

MCP_DOMAIN=mcp.example.com

Соберите и запустите в фоновом режиме:

docker compose --env-file deploy.env up -d --build

Проверьте статус и логи:

docker compose --env-file deploy.env ps
docker compose --env-file deploy.env logs --tail=100

После выпуска сертификата адрес MCP будет:

https://mcp.example.com/mcp

4. Проверка обнаружения и вызова инструмента

Выполните на локальном Mac, чтобы проверить публичный канал:

/opt/homebrew/Caskroom/miniconda/base/bin/python \
  "/Users/clarence/Desktop/项目/兴先达/MCP测试/verify_remote.py" \
  https://mcp.example.com/mcp

При успехе отобразится:

发现工具：mcp_connection_test
调用返回：MCP连接成功

Этот шаг реально выполняет инициализацию MCP, tools/list и tools/call, что точнее, чем обычная проверка порта или проверка HTTP.

5. Конфигурация вышестоящей системы

Настройте URL сервера вышестоящего MCP-клиента:

https://mcp.example.com/mcp

Имя инструмента:

mcp_connection_test

Параметры вызова могут быть пустым объектом:

{}

Также можно передать проверочные данные:

{
  "probe": "upstream-health-check"
}

Обновление и остановка

После обновления кода выполните повторное развертывание:

docker compose --env-file deploy.env up -d --build

Остановите сервис:

docker compose --env-file deploy.env down

Часто задаваемые вопросы

• Возвращается 421 Invalid Host header: домен в deploy.env не совпадает с доменом доступа.

• HTTPS-сертификат не выпущен: проверьте A-запись домена и порты 80, 443 в группе безопасности.

• Просмотр логов MCP-сервиса: docker compose --env-file deploy.env logs mcp-server.

• Просмотр логов HTTPS-прокси: docker compose --env-file deploy.env logs caddy.

В настоящее время сервис не имеет аутентификации, поскольку в нём есть только инструмент проверки подключения без побочных эффектов. Если в дальнейшем будут добавлены реальные бизнес-инструменты, следует добавить аутентификацию MCP, либо разрешить в облачной группе безопасности доступ только с фиксированного IP вышестоящей системы.