// Use when MCP server code is modified and needs full E2E verification against a real dbt project. Triggers after changes to recce/mcp_server.py, MCP tool handlers, single-env logic, or error classification. Also use before merging MCP PRs.
| name | recce-mcp-e2e |
| description | Use when MCP server code is modified and needs full E2E verification against a real dbt project. Triggers after changes to recce/mcp_server.py, MCP tool handlers, single-env logic, or error classification. Also use before merging MCP PRs. |
Full-stack verification of all 8 MCP tools against a real dbt project.
recce/mcp_server.py or _tool_* handlersInvoke as /recce-mcp-e2e or /recce-mcp-e2e <project_path>.
The project directory must contain target/manifest.json and target-base/manifest.json.
target/ and target-base/ exist with manifest.jsonrecce/mcp_server.py. If recce-nightly is also installed (pip show recce recce-nightly), set PYTHONPATH=<RECCE_REPO_ROOT>:$PYTHONPATHtest_mcp_e2e.py in the project directory from test_mcp_e2e_template.py (in this skill directory). Replace PROJECT_DIR_PLACEHOLDER with the resolved absolute path.=== FULL MODE (8 tools) ===
PASS lineage_diff: PASS
...
=== SINGLE-ENV MODE ===
PASS row_count_diff (_warning): PASS
...
ALL PASS
test_mcp_e2e.py| Test Suite | Checks | What's Verified |
|---|---|---|
| Full mode (8 tools) | lineage_diff, schema_diff, row_count_diff, query, query_diff, profile_diff, list_checks, run_check | Non-empty results from each tool |
| Single-env _warning (3) | row_count_diff, query_diff, profile_diff | _warning field present with SINGLE_ENV_WARNING |
| Single-env no _warning (2) | lineage_diff, schema_diff | _warning field NOT present |
Additional manual checks (not in script):
| Check | Command/Action |
|---|---|
| --help | recce mcp-server --help shows Prerequisites section |
| Server modes | Non-server mode: list_tools returns only lineage_diff + schema_diff |
| Problem | Fix |
|---|---|
ImportError: cannot import name 'SINGLE_ENV_WARNING' | recce-nightly conflict — use PYTHONPATH=<RECCE_REPO_ROOT>:$PYTHONPATH |
| lineage_diff returns empty | Use view_mode="all" (default changed_models filters out unchanged) |
| list_checks returns empty | Preset checks from recce.yml must be loaded via load_preset_checks() — script handles this |
portalocker FileNotFoundError on exit | Cosmetic thread error in event collector — does not affect results |
| Single-env test uses target-base | By design — load_context needs both, single_env=True flag simulates the mode |
Use when consolidating open Dependabot PRs into a single branch. Fetches all open Dependabot PRs from the repo, applies dependency updates locally, tests for breakage, and creates a single PR that closes all Dependabot PRs.
Use when given a Linear issue ID, URL, identifier, or project name/URL to analyze and plan work. For issues, fetches the issue, classifies it, explores relevant code, proposes an approach, and orchestrates the right skills. For projects, fetches the project with milestones and issues, builds a prioritized execution plan, and systematically works through issues respecting project structure and dependencies.
Use when modifying recce/mcp_server.py, MCP tool handlers, error classification, or MCP-related tests. Also use when adding new MCP tools or changing tool response formats.