MCP E2E 测试 :: ShardingSphere

MCP E2E 测试

本章说明 ShardingSphere-MCP 的端到端契约验证和 LLM smoke 验证。

范围

test/e2e/mcp 覆盖：

发行包启动和配置。
HTTP runtime。
STDIO runtime。
MCP baseline contract。
Tool/resource/prompt/completion discovery。
真实模型驱动的 MCP smoke。
Encrypt 和 Mask workflow 可用性验证。

本地准备

先安装 MCP E2E 依赖模块到本地仓库：

./mvnw -pl test/e2e/mcp -am install -DskipTests -DskipITs -Dspotless.skip=true -B -ntp

LLM Runtime

MCP LLM lane 默认使用本地 Docker image 承载 OpenAI-compatible endpoint。构建前建议先查看 Docker 占用：

docker system df

只校验本机架构选择，不下载模型：

sh test/e2e/mcp/src/test/resources/docker/llm-runtime/build-local.sh --dry-run

构建本地 runtime image：

sh test/e2e/mcp/src/test/resources/docker/llm-runtime/build-local.sh

运行 LLM Smoke

./mvnw -pl test/e2e/mcp -Pllm-e2e test -DskipITs -Dspotless.skip=true \
  -Dtest=LLMSmokeE2ETest \
  -Dsurefire.failIfNoSpecifiedTests=true

运行 LLM Usability Suite

./mvnw -pl test/e2e/mcp -Pllm-e2e test -DskipITs -Dspotless.skip=true \
  -Dtest=LLMUsabilitySuiteE2ETest \
  -Dsurefire.failIfNoSpecifiedTests=true

External Debug

仅本地调试时，可以连接已经运行的 OpenAI-compatible endpoint：

./mvnw -pl test/e2e/mcp -Pllm-e2e test -DskipITs -Dspotless.skip=true \
  -Dtest=LLMSmokeE2ETest \
  -Dmcp.llm.runtime-mode=external-debug \
  -Dmcp.llm.base-url=http://127.0.0.1:8080/v1 \
  -Dsurefire.failIfNoSpecifiedTests=true

External debug endpoint 不能作为 score-closing evidence。

产物

LLM artifact 写入：

test/e2e/mcp/target/llm-e2e/

GitHub Actions 入口：

.github/workflows/mcp-llm-e2e.yml
.github/workflows/mcp-llm-usability-e2e.yml

这两条检查用于提供额外可见性，不应单独配置成 branch protection 或 ruleset 的 required check。如果超大 PR 因 path filter 限制漏触发，可以使用 workflow_dispatch 手动补充 evidence。