QA-MCP: Test Standardization & Orchestration Server

Instructions

Implementation Reference

• src/qa_mcp/tools/to_xray.py:279-315 (handler)

  The handler function that executes the 'xray.get_mapping_template' tool. It returns a predefined dictionary containing standard mappings, custom field suggestions, Xray-specific fields, and notes for configuring Xray field mappings.

  def get_xray_field_mapping_template() -> dict:
      """
      Get a template for Xray field mappings.
  
      Returns:
          Dictionary with QA-MCP fields and suggested Xray mappings
      """
      return {
          "standard_mappings": {
              "title": "summary",
              "description": "description",
              "priority": "priority",
              "module": "components",
              "tags": "labels",
              "labels": "labels",
              "steps": "Test Steps (Xray built-in)",
              "preconditions": "Precondition (Xray built-in)",
          },
          "custom_field_suggestions": {
              "risk_level": "customfield_XXXXX (Text/Select)",
              "scenario_type": "customfield_XXXXX (Select)",
              "feature": "customfield_XXXXX (Text)",
              "estimated_duration_minutes": "customfield_XXXXX (Number)",
              "requirements": "customfield_XXXXX (Text) veya Issue Links",
          },
          "xray_specific": {
              "test_type": "testtype (Manual/Generic/Cucumber)",
              "test_repository_folder": "Xray Test Repository klasörü",
              "test_sets": "Test Set issue links",
              "test_plans": "Test Plan issue links",
          },
          "notes": [
              "Custom field ID'leri Jira admin'den alınmalı",
              "Select tipi alanlar için önce option'lar oluşturulmalı",
              "Issue links için link type tanımlanmalı",
          ],
      }

• src/qa_mcp/server.py:291-298 (registration)

  The tool registration in the list_tools() handler, defining the tool name, description, and input schema (no required parameters).

  Tool(
      name="xray.get_mapping_template",
      description="Xray alan eşleme şablonunu döner",
      inputSchema={
          "type": "object",
          "properties": {},
      },
  ),

• src/qa_mcp/server.py:294-298 (schema)

  The input schema for the tool, which is an empty object (no input parameters expected).

      inputSchema={
          "type": "object",
          "properties": {},
      },
  ),

• src/qa_mcp/server.py:395-397 (handler)

  The dispatch logic in the generic call_tool() function that invokes the specific handler for this tool.

  elif name == "xray.get_mapping_template":
      result = get_xray_field_mapping_template()
      audit_log(name, arguments, "Returned mapping template")