Cloud-MCP-Server-Verbindungstest-Tool

Dies ist ein Cloud-MCP-Server, der ausschließlich Streamable HTTP verwendet. Der öffentliche Zugang lautet:

https://你的域名/mcp

Der Upstream kann mcp_connection_test erkennen und aufrufen; nach dem Aufruf wird immer MCP连接成功 zurückgegeben. Das Tool ruft keine Modelle auf und benötigt keinen API-Key.

Deployment-Struktur

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

Caddy beantragt und erneuert HTTPS-Zertifikate automatisch. Der Port 8000 des MCP-Servers ist nicht direkt öffentlich erreichbar.

Related MCP server: MCP MCPO Demo Server

1. Server und Domain vorbereiten

1. Docker Engine und das Docker-Compose-Plugin auf dem Cloud-Server installieren.

2. Eine Domain vorbereiten, z. B. mcp.example.com.

3. Einen A-Record für die Domain hinzufügen, der auf die öffentliche IP des Cloud-Servers zeigt.

4. TCP 80 und 443 in der Sicherheitsgruppe des Cloud-Anbieters und der Server-Firewall freigeben.

In MCP_DOMAIN nur die Domain eintragen, ohne https:// oder Pfad.

2. Projekt hochladen

Auf dem lokalen Mac ausführen und SERVER_USER und SERVER_IP durch die tatsächlichen Werte ersetzen. Das lokale .env und die virtuelle Umgebung werden hier ausdrücklich ausgeschlossen, um zu vermeiden, dass alte API-Keys oder nicht zusammenhängende Dateien auf den Server hochgeladen werden:

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

Auf dem Server anmelden:

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

3. Domain eintragen und starten

cp deploy.env.example deploy.env

deploy.env bearbeiten:

MCP_DOMAIN=mcp.example.com

Erstellen und im Hintergrund starten:

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

Betriebsstatus und Protokolle anzeigen:

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

Nach Ausstellung des Zertifikats lautet die MCP-Adresse:

https://mcp.example.com/mcp

4. Tool-Erkennung und -Aufruf verifizieren

Auf dem lokalen Mac ausführen, um die öffentliche Netzwerkverbindung zu verifizieren:

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

Bei Erfolg wird Folgendes angezeigt:

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

Dieser Schritt führt tatsächlich die MCP-Initialisierung sowie tools/list und tools/call aus und ist damit genauer als eine gewöhnliche Port- oder HTTP-Prüfung.

5. Upstream-Konfiguration

Die Server-URL des Upstream-MCP-Clients wie folgt konfigurieren:

https://mcp.example.com/mcp

Tool-Name:

mcp_connection_test

Die Aufrufparameter können ein leeres Objekt sein:

{}

Es können auch Testinhalte übergeben werden:

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

Aktualisierung und Stopp

Nach der Aktualisierung des Codes erneut bereitstellen:

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

Dienst stoppen:

docker compose --env-file deploy.env down

Häufig gestellte Fragen

• 421 Invalid Host header wird zurückgegeben: Die Domain in deploy.env stimmt nicht mit der Zugriffsdomain überein.

• HTTPS-Zertifikat nicht ausgestellt: A-Record der Domain sowie die Ports 80 und 443 der Sicherheitsgruppe prüfen.

• MCP-Dienstprotokolle anzeigen: docker compose --env-file deploy.env logs mcp-server.

• HTTPS-Proxy-Protokolle anzeigen: docker compose --env-file deploy.env logs caddy.

Der aktuelle Dienst verfügt über keine Authentifizierung, da er nur ein Verbindungstest-Tool ohne Nebenwirkungen enthält. Wenn später echte Geschäftstools hinzugefügt werden, sollte eine MCP-Authentifizierung eingerichtet werden oder in der Cloud-Sicherheitsgruppe nur der Zugriff von der festen Upstream-IP erlaubt werden.