MCPlanManager

Instructions

Implementation Reference

• src/mcplanmanager/app.py:171-183 (handler)

  MCP tool handler and registration for 'getTaskList'. This thin wrapper delegates to PlanManager.getTaskList() and uses type hints for schema.

  @mcp.tool()
  def getTaskList(status_filter: Optional[str] = None) -> ToolResponse[List[TaskOutput]]:
      """
      获取计划中所有任务的列表，可按状态进行过滤。
  
      Args:
          status_filter (str, optional): 用于过滤任务的状态字符串。
                                       可接受的值: 'pending', 'in_progress', 'completed', 'failed', 'skipped'。
      
      Returns:
            ToolResponse[List[TaskOutput]]: 包含任务列表的响应对象。
      """
      return plan_manager.getTaskList(status_filter)

• src/mcplanmanager/plan_manager.py:336-347 (helper)

  Core logic implementation of getTaskList in PlanManager class, filters tasks by status_filter if provided and returns them wrapped in a dict.

  def getTaskList(self, status_filter: Optional[str] = None) -> Dict:
      """获取任务列表，可按状态过滤"""
      if status_filter:
          tasks_to_return = [
              task for task in self.plan_data["tasks"] 
              if task["status"] == status_filter
          ]
      else:
          tasks_to_return = self.plan_data["tasks"]
      
      return {"success": True, "data": tasks_to_return}

• src/mcplanmanager/models.py:33-43 (schema)

  Pydantic model defining the structure of each TaskOutput in the list returned by getTaskList.

  class TaskOutput(BaseModel):
      """
      用于工具函数返回任务信息时，定义单个任务输出的Pydantic模型。
      """
      id: int
      name: str
      status: str
      dependencies: List[int]
      reasoning: str
      result: Optional[str] = None

• src/mcplanmanager/models.py:5-13 (schema)

  Generic Pydantic model for ToolResponse[T], used as return type ToolResponse[List[TaskOutput]] for getTaskList.

  class ToolResponse(BaseModel, Generic[T]):
      """
      一个通用的工具响应模型，用于标准化所有工具的返回结构。
      """
      success: bool = Field(True, description="操作是否成功。")
      message: Optional[str] = Field(None, description="关于操作结果的可读消息。")
      data: Optional[T] = Field(None, description="操作返回的主要数据负载。")