云端 MCP Server 连接测试工具

这是一个只使用 Streamable HTTP 的云端 MCP Server。公网入口为：

https://你的域名/mcp

上游能够发现并调用 mcp_connection_test，调用后固定返回 MCP连接成功。工具不调用模型，也不需要 API Key。

部署结构

上游 MCP 客户端 -> 已有 HTTPS 服务 443 -> 127.0.0.1:18080 -> MCP 容器 8000

项目不再启动 Caddy，也不占用 80、443。MCP 只绑定服务器本机回环地址， 由现有 Nginx、Apache 或 Caddy 使用已有证书反向代理。

一、准备服务器和域名

1. 云服务器安装 Docker Engine 和 Docker Compose 插件。
2. 准备已有证书覆盖的域名，例如 mcp.example.com。
3. 确认现有 HTTPS 服务能够修改反向代理配置。

MCP_DOMAIN 只填写域名，不要包含 https:// 或路径。

二、上传项目

在本地 Mac 执行，将 SERVER_USER 和 SERVER_IP 换成真实值。这里明确排除 本地 .env 和虚拟环境，避免把旧 API Key 或无关文件上传到服务器：

rsync -av \
  --exclude='.env' \
  --exclude='.venv' \
  --exclude='__pycache__' \
  "/Users/clarence/Desktop/项目/兴先达/MCPtest/" \
  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
MCP_LOCAL_PORT=18080

如果 18080 已被占用，可以改成其他未使用的高位端口，例如 18081。检查端口：

sudo ss -ltnp | grep ':18080'

构建并后台启动：

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

如果之前启动过旧版 Caddy 编排，使用下面的命令同时清理已经移除的 Caddy 容器；不会影响服务器上其他项目的容器：

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

查看运行状态和日志：

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

四、接入现有 HTTPS 服务

如果使用 Nginx，将 nginx-mcp-location.conf.example 中的 location /mcp 配置加入已有证书域名对应的 server { ... } 中。确认反向代理端口与 MCP_LOCAL_PORT 一致，然后执行：

sudo nginx -t
sudo systemctl reload nginx

Nginx 的 proxy_pass 应指向：

http://127.0.0.1:18080

最终公网 MCP 地址仍然是：

https://mcp.example.com/mcp

五、验证工具发现和调用

在本地 Mac 执行，验证公网链路：

/opt/homebrew/Caskroom/miniconda/base/bin/python \
  "/Users/clarence/Desktop/项目/兴先达/MCPtest/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 中的域名与访问域名不一致。
• 出现 Connection refused：检查 MCP_LOCAL_PORT、容器状态及反向代理端口是否一致。
• 查看 MCP 服务日志：docker compose --env-file deploy.env logs mcp-server。
• HTTPS 相关问题继续查看服务器现有 Nginx、Apache 或 Caddy 日志。

当前服务没有身份认证，因为它只有一个无副作用的连接测试工具。如果以后添加 真实业务工具，应增加 MCP 鉴权，或者在云安全组中只允许上游固定 IP 访问。