informatics-isi-edu / deriva-mcp-core / 23942345389

91%

push

github

  Add MCP guide prompts, trim tool docstrings, and reduce log noise

  Introduce tools/prompts.py with four built-in MCP prompts (query_guide,
  entity_guide, annotation_guide, catalog_guide) containing behavioral
  guidance for LLM tool usage: ERMrest path syntax, join patterns,
  preflight count rules, empty-result handling, display rules, annotation
  context names, and catalog snaptime format.

  Trim docstrings in entity.py, query.py, catalog.py, and annotation.py
  to reference the guide prompts instead of carrying full behavioral
  guidance inline -- reduces per-tool-call token cost.

  Guide prompts include strong directives for common LLM failure modes:
  - "USE THE SCHEMA CONTEXT" -- do not call get_schema to re-explore
  - "STOP -- USE THE RIGHT TOOL" -- use query_attribute joins, not N+1
    get_entities calls across individual tables
  - "EMPTY RESULTS ARE VALID" -- zero rows is a complete answer, do not
    reformulate or investigate intermediate tables
  - "DISPLAY RULES (MANDATORY)" -- never drop columns or truncate values

  Add server instructions via FastMCP constructor so MCP clients receive
  tool-group guidance at init time. Register prompts module in server.py.

  Suppress noisy per-request log lines: demote verifier "Authenticated"
  to DEBUG (already in audit log), suppress mcp.server.streamable_http
  "Terminating session: None" at WARNING level.

  Update gap_analysis.md and workplan-deriva-mcp-core.md

25 of 26 new or added lines in 3 files covered. (96.15%)

2547 of 2805 relevant lines covered (90.8%)

0.91 hits per line