Qinglong MCP Server

Instructions

Implementation Reference

• server.py:295-336 (handler)

  Handler implementation for the get_task_status tool. Retrieves task status from Qinglong API endpoint /open/crons/{task_id}, maps status codes to human-readable text, and constructs a formatted output with task details including name, status, disabled/pinned flags, last run time, and last execution time.

  elif tool_name == "get_task_status":
      task_id = arguments.get("task_id")
      try:
          url = f"{QINGLONG_URL}/open/crons/{task_id}"
          headers = {"Authorization": f"Bearer {token}"}
          resp = requests.get(url, headers=headers, timeout=10)
          result = resp.json()
      except Exception as e:
          response = {
              "jsonrpc": "2.0",
              "id": request["id"],
              "error": {"code": -32603, "message": f"请求失败: {str(e)}"}
          }
          print(json.dumps(response), flush=True)
          continue
      
      if result.get("code") == 200:
          cron = result["data"]
          status_map = {0: "运行中", 1: "空闲", 2: "禁用"}
          status = status_map.get(cron.get("status"), "未知")
          
          output = f"任务 {task_id} 状态信息:\n\n"
          output += f"名称: {cron.get('name')}\n"
          output += f"状态: {status}\n"
          output += f"是否禁用: {'是' if cron.get('isDisabled') == 1 else '否'}\n"
          output += f"是否置顶: {'是' if cron.get('isPinned') == 1 else '否'}\n"
          last_running = cron.get('last_running_time')
          output += f"上次运行时长: {last_running}秒\n" if last_running else "上次运行时长: 未运行\n"
          output += f"最后执行时间: {cron.get('last_execution_time', '未执行')}\n"
          
          response = {
              "jsonrpc": "2.0",
              "id": request["id"],
              "result": {"content": [{"type": "text", "text": output}]}
          }
      else:
          response = {
              "jsonrpc": "2.0",
              "id": request["id"],
              "error": {"code": -32603, "message": f"获取任务状态失败: {result}"}
          }

• server.py:123-133 (registration)

  Registration of the get_task_status tool in the tools/list method response, including name, description, and input schema requiring a task_id integer.

  {
      "name": "get_task_status",
      "description": "获取青龙面板中指定任务的执行状态",
      "inputSchema": {
          "type": "object",
          "properties": {
              "task_id": {"type": "integer", "description": "任务 ID"}
          },
          "required": ["task_id"]
      }
  },

• server.py:126-131 (schema)

  Input schema for get_task_status tool: requires a single integer property 'task_id'.

  "inputSchema": {
      "type": "object",
      "properties": {
          "task_id": {"type": "integer", "description": "任务 ID"}
      },
      "required": ["task_id"]