Mingli MCP Server

Instructions

Implementation Reference

• mcp/tools/bazi_handlers.py:137-159 (handler)

  Main handler function that executes the analyze_bazi_element tool logic: validates parameters, retrieves Bazi system, performs element analysis, and formats output.

  @log_performance
  def handle_analyze_bazi_element(args: Dict[str, Any]) -> str:
      """工具：分析八字五行"""
      # Validate parameters
      _validate_common_params(
          args,
          ["birth_date", "time_index", "gender"],
          BAZI_ELEMENT_PARAM_DESCRIPTIONS,
          date_key="birth_date",
      )
  
      with PerformanceTimer("八字五行分析"):
          birth_info = _build_birth_info(args, date_key="birth_date")
  
          system = get_system("bazi")
          analysis = system.analyze_element(birth_info)
  
          output_format = args.get("format", "markdown")
          if output_format == "json":
              return _format_response(analysis, "json")
          else:
              return _bazi_formatter.format_element_analysis(analysis, "markdown")

• mcp/tools/definitions.py:354-403 (schema)

  Tool schema definition including input parameters, descriptions, required fields, and annotations.

  def get_analyze_bazi_element_definition() -> Dict[str, Any]:
      """Get definition for analyze_bazi_element tool"""
      return {
          "name": "analyze_bazi_element",
          "description": "分析八字五行强弱，包含五行分数、平衡度、缺失五行等",
          "annotations": {
              "readOnlyHint": True,
              "destructiveHint": False,
              "idempotentHint": True,
          },
          "inputSchema": {
              "type": "object",
              "properties": {
                  "birth_date": {
                      "type": "string",
                      "description": "出生日期，格式：YYYY-MM-DD",
                  },
                  "time_index": {
                      "type": "integer",
                      "description": "出生时辰序号（0-12）",
                      "minimum": 0,
                      "maximum": 12,
                  },
                  "gender": {
                      "type": "string",
                      "enum": ["男", "女"],
                  },
                  "calendar": {
                      "type": "string",
                      "enum": ["solar", "lunar"],
                      "default": "solar",
                  },
                  "is_leap_month": {
                      "type": "boolean",
                      "default": False,
                  },
                  "format": {
                      "type": "string",
                      "enum": ["json", "markdown"],
                      "default": "markdown",
                  },
                  "language": {
                      "type": "string",
                      "enum": ["zh-CN", "zh-TW", "en-US", "ja-JP", "ko-KR", "vi-VN"],
                      "default": "zh-CN",
                  },
              },
              "required": ["birth_date", "time_index", "gender"],
          },
      }

• mcp/tools/__init__.py:37-41 (registration)

  Registration of the analyze_bazi_element handler in the ToolRegistry during initialization.

  # Bazi tools
  self.register("get_bazi_chart", handle_get_bazi_chart)
  self.register("get_bazi_fortune", handle_get_bazi_fortune)
  self.register("analyze_bazi_element", handle_analyze_bazi_element)

• mcp/tools/__init__.py:9-13 (registration)

  Import of the handler function for registration.

  from mcp.tools.bazi_handlers import (
      handle_analyze_bazi_element,
      handle_get_bazi_chart,
      handle_get_bazi_fortune,
  )

• mcp/tools/bazi_handlers.py:38-42 (helper)

  Parameter descriptions used for validation error messages in the handler.

  BAZI_ELEMENT_PARAM_DESCRIPTIONS = {
      "birth_date": "出生日期 (格式: YYYY-MM-DD)",
      "time_index": "出生时辰序号 (0-12)",
      "gender": "性别 (男/女)",
  }