Mingli MCP Server

Instructions

Implementation Reference

• mcp/tools/__init__.py:60-91 (handler)

  The _handle_list_systems method implements the core logic of the list_fortune_systems tool, listing all available fortune systems with their capabilities, versions, and optional palace support.

  def _handle_list_systems(self, args: Dict[str, Any]) -> str:
      """工具：列出所有命理系统"""
      from systems import get_system, list_systems
  
      systems = list_systems()
      detailed = bool(args.get("detailed", False))
  
      result = "# 可用的命理系统\n\n"
      for system_name in systems:
          try:
              system = get_system(system_name)
              capabilities = system.get_capabilities()
  
              result += f"## {system.get_system_name()}\n\n"
              result += f"- **版本**: {system.get_system_version()}\n"
              result += f"- **系统ID**: {system_name}\n"
              result += "- **功能支持**:\n"
              for cap_name, cap_value in capabilities.items():
                  status = "✅" if cap_value else "❌"
                  result += f"  - {cap_name}: {status}\n"
  
              if detailed and hasattr(system, "get_supported_palaces"):
                  palaces = system.get_supported_palaces()
                  if palaces:
                      result += f"- **支持宫位**: {', '.join(palaces)}\n"
  
              result += "\n"
          except Exception as e:
              result += f"## {system_name}\n\n"
              result += f"- **状态**: 加载失败 - {str(e)}\n\n"
  
      return result

• mcp/tools/definitions.py:221-243 (schema)

  The schema definition for the list_fortune_systems tool, including input schema for optional 'detailed' parameter.

  def get_list_fortune_systems_definition() -> Dict[str, Any]:
      """Get definition for list_fortune_systems tool"""
      return {
          "name": "list_fortune_systems",
          "description": "列出所有可用的命理系统（紫微斗数、八字、占星等）",
          "annotations": {
              "readOnlyHint": True,
              "destructiveHint": False,
              "idempotentHint": True,
          },
          "inputSchema": {
              "type": "object",
              "properties": {
                  "detailed": {
                      "type": "boolean",
                      "description": "是否输出更详细信息",
                      "default": False,
                  }
              },
              "required": [],
              "additionalProperties": False,
          },
      }

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

  Registration of the list_fortune_systems tool handler in the ToolRegistry.

  self.register("list_fortune_systems", self._handle_list_systems)

• mcp/tools/definitions.py:412-412 (registration)

  Registration of the list_fortune_systems schema in the get_all_tool_definitions function.

  get_list_fortune_systems_definition(),