Herramienta de prueba de conexión del servidor MCP en la nube

Este es un servidor MCP en la nube que utiliza únicamente Streamable HTTP. La entrada pública es:

https://你的域名/mcp

El upstream puede descubrir e invocar mcp_connection_test, que devuelve fijamente MCP连接成功. La herramienta no invoca modelos ni requiere API Key.

Estructura de implementación

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

Caddy solicita y renueva automáticamente los certificados HTTPS, y el puerto 8000 del servidor MCP no se expone directamente a la red pública.

Related MCP server: MCP MCPO Demo Server

一、Preparación del servidor y el dominio

1. Instalar Docker Engine y el plugin Docker Compose en el servidor en la nube.

2. Preparar un dominio, por ejemplo mcp.example.com.

3. Añadir un registro A para ese dominio, apuntando a la IP pública del servidor en la nube.

4. Permitir el tráfico TCP en los puertos 80 y 443 en el grupo de seguridad del proveedor de la nube y en el firewall del servidor.

MCP_DOMAIN solo debe contener el dominio, sin incluir https:// ni rutas.

二、Subida del proyecto

En la Mac local, ejecute lo siguiente, reemplazando SERVER_USER y SERVER_IP por los valores reales. Aquí se excluye explícitamente el .env local y el entorno virtual, para evitar subir claves API antiguas o archivos irrelevantes al servidor:

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

Inicie sesión en el servidor:

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

三、Rellenar el dominio e iniciar

cp deploy.env.example deploy.env

Edite deploy.env:

MCP_DOMAIN=mcp.example.com

Construya e inicie en segundo plano:

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

Consulte el estado de ejecución y los registros:

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

Una vez emitido el certificado, la dirección MCP es:

https://mcp.example.com/mcp

四、Verificación del descubrimiento e invocación de la herramienta

En la Mac local, ejecute lo siguiente para verificar el enlace público:

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

Si tiene éxito, se mostrará:

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

Este paso ejecuta realmente la inicialización de MCP, tools/list y tools/call, lo que resulta más preciso que una simple comprobación de puerto o HTTP.

五、Configuración del upstream

Configure la URL del servidor del cliente MCP upstream como:

https://mcp.example.com/mcp

Nombre de la herramienta:

mcp_connection_test

Los parámetros de invocación pueden ser un objeto vacío:

{}

También puede pasar contenido de prueba:

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

Actualización y detención

Tras actualizar el código, vuelva a implementar:

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

Detenga el servicio:

docker compose --env-file deploy.env down

Preguntas frecuentes

• Si devuelve 421 Invalid Host header: el dominio en deploy.env no coincide con el dominio utilizado para acceder.

• Si el certificado HTTPS no se emite: compruebe el registro A del dominio y los puertos 80 y 443 del grupo de seguridad.

• Ver los registros del servicio MCP: docker compose --env-file deploy.env logs mcp-server.

• Ver los registros del proxy HTTPS: docker compose --env-file deploy.env logs caddy.

El servicio actual no tiene autenticación, porque solo expone una herramienta de prueba de conexión sin efectos secundarios. Si en el futuro se añaden herramientas de negocio reales, se debe implementar autenticación MCP, o restringir en el grupo de seguridad de la nube el acceso únicamente a la IP fija del upstream.