PYMCP_006_TOOL_SIGNATURE_DISCIPLINE: Tool-Funktion: Name, Docstring, vollstaendige Type-Hints

Severity: must. Bereich: python-mcp.

Regel

Jede @mcp.tool() Funktion MUSS einen fachlichen snake_case-Namen ohne technische Praefixe (kein get_, do_), einen Docstring mit Kurzfassung plus Argumentbedingungen sowie Type-Hints fuer alle Parameter und den Return-Typ tragen. Das daraus erzeugte JSON-Schema ist der einzige Vertrag zwischen LLM und Tool.

Reflection-Check

check:
  reflect:
    fields:
    - parameter_typed
    - return_annotated
    - has_docstring
    object: tool_definition

Evidence

• MCP_PYTHON_SDK, Model Context Protocol — Python SDK
• MCP_SPEC, Model Context Protocol Specification

alle Regeln dieses Bereichs