Peter Steinberger e18af40078 docs: add front matter to live tests

2025-12-30 00:09:03 +01:00

summary

read_when

Opt-in live MCP integration tests that hit real hosted servers (off by default in CI).

Running end-to-end validation against hosted MCP servers

Live MCP Tests

These tests hit real hosted MCP servers and require outbound HTTP. They are off by default to keep CI and local runs deterministic.

When to run

Before releases when you want end-to-end validation against hosted servers.
When debugging regressions that only repro against real servers (e.g., DeepWiki).

MCP_LIVE_TESTS=1 pnpm test:live

This runs the Vitest suite under tests/live, in-band, with longer timeouts.

DeepWiki (both wire protocols):
- Streamable HTTP: https://mcp.deepwiki.com/mcp
- SSE: https://mcp.deepwiki.com/sse
- Test: calls read_wiki_structure repoName:facebook/react and asserts a non-empty result.

Tests are skipped entirely unless MCP_LIVE_TESTS=1 is set.
Ensure network egress is allowed. No secrets are required for the current DeepWiki checks.
Keep assertions minimal to reduce flake; these are availability smokes, not full contract tests.