FreeOnePlus opened a new pull request, #169: URL: https://github.com/apache/doris-mcp-server/pull/169
## Summary - expose eight stable read-only domain tools in hierarchical mode and 47 exact formal child tools in flat mode - add deterministic child discovery, exact dispatch, strict input/output schema validation, stable result/error envelopes, and formal audit names - remove pre-1.0 tool-name routing and fuzzy client-side tool selection - keep currently bound production handlers callable through an explicit degraded fallback while unbound capabilities remain fail closed - add `MCP_TOOL_EXPOSURE_MODE=hierarchical|flat` across environment, JSON configuration, multi-worker propagation, and public documentation ## Why The pre-1.0 flat registry exposed too many unrelated tools at once and the packaged client selected tools by fuzzy name or description matching. That made discovery context-heavy and execution behavior less deterministic. The new contract gives Hosts a stable domain surface, progressive disclosure, exact child names, and a formal flat compatibility mode without retaining legacy aliases. ## User and developer impact - Hosts can discover a bounded domain manifest and invoke an exact child through the same top-level domain tool. - Deployments that require flat registration can expose the same 47 child contracts through collision-free formal names. - Existing pre-1.0 top-level names are intentionally removed; callers must migrate to domain children or formal flat names. - The packaged Python client now performs exact hierarchical or flat dispatch and never guesses a tool. - Bound handlers are immediately usable in production with a clearly marked degraded availability status; capabilities without handlers remain visible but not callable. ## Validation - `uv run pytest -q --no-cov`: 1453 passed, 69 skipped - `uv run pytest -q -W error`: 1453 passed, 69 skipped; 63.02% coverage - coverage-domain gates: protocol 90.31%, authentication 81.55%, core managers 81.88% - `uv run ruff check .` - `uv run mypy doris_mcp_server` - `uv lock --check` - `uv run bandit -q -r doris_mcp_server` - `uv build` - isolated wheel install, imports, CLI help, 8/47 surface, and 21 default callable children - official MCP SDK acceptance in hierarchical and flat modes against a real Doris 4.0.5 RC cluster - Codex Host acceptance for progressive discovery, exact execution, domain switching, legacy-name absence, flat mode, and the default production availability provider - four independent pre-commit reviews; all actionable findings were fixed and the final review reported no regressions -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
