클라우드 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. 서버와 도메인 준비

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. 업스트림 구성

업스트림 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만 허용해야 합니다.