クラウド MCP Server 接続テストツール

これは Streamable HTTP のみを使用するクラウド MCP Server です。公開エントリポイントは次のとおりです：

https://你的域名/mcp

アップストリームは mcp_connection_test を検出・呼び出しでき、呼び出し後は常に MCP连接成功 を返します。このツールはモデルを呼び出さず、API Key も不要です。

デプロイ構成

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

Caddy が HTTPS 証明書を自動取得・更新し、MCP Server の 8000 ポートはパブリックネットワークに直接公開されません。

Related MCP server: MCP MCPO Demo Server

一、サーバーとドメインの準備

1. クラウドサーバーに Docker Engine と Docker Compose プラグインをインストールします。

2. ドメインを準備します（例：mcp.example.com）。

3. そのドメインに A レコードを追加し、クラウドサーバーのパブリック IP を指すようにします。

4. クラウドベンダーのセキュリティグループとサーバーファイアウォールで TCP 80、443 を許可します。

MCP_DOMAIN にはドメイン名のみを入力し、https:// やパスは含めないでください。

二、プロジェクトのアップロード

ローカルの 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

三、ドメインの入力と起動

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

四、ツールの検出と呼び出しの検証

ローカルの 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 チェックよりも正確です。

五、アップストリーム設定

アップストリーム MCP クライアントのサーバー URL を次のように設定します：

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 のみを許可する必要があります。