MCP Reminder

Instructions

Implementation Reference

• src/mcp_reminder/server.py:142-193 (handler)

  The `add_todo` tool handler, registered with the MCP server, responsible for parsing the reminder time, creating a `Todo` object, and persisting it via the storage layer.

  @mcp.tool()
  def add_todo(title: str, remind_time: str = "", description: str = "") -> dict:
      """
      添加待办事项
  
      Args:
          title: 待办事项标题
          remind_time: 提醒时间（可选），支持自然语言如"明天下午3点"
          description: 待办事项描述（可选）
  
      Returns:
          包含待办ID和确认信息的字典
      """
      if not title:
          return {
              "success": False,
              "error": "待办事项标题不能为空"
          }
  
      # 解析提醒时间
      parsed_remind_time = None
      if remind_time:
          parsed_remind_time = parse_time(remind_time)
          if not parsed_remind_time:
              return {
                  "success": False,
                  "error": f"无法解析提醒时间: {remind_time}"
              }
  
      # 创建待办事项
      todo = Todo(
          title=title,
          description=description,
          remind_time=parsed_remind_time
      )
  
      # 保存待办
      storage.add_todo(todo)
  
      logger.info(f"添加待办: {todo.title}, 提醒时间: {todo.remind_time}")
  
      message = f"已添加待办: {title}"
      if parsed_remind_time:
          message += f"，将在 {parsed_remind_time} 提醒"
  
      return {
          "success": True,
          "todo_id": todo.id,
          "title": todo.title,
          "remind_time": todo.remind_time,
          "message": message
      }