Tasks MCP Server

Instructions

Implementation Reference

• src/tools/tasks.py:10-23 (handler)

  The core handler function for the 'tasks_list_tool' that executes the logic to fetch and return a list of tasks from the database, limited by task_limit.
  @mcp.tool() async def tasks_list_tool( ctx: Context[ServerSession, AppContext], task_limit: int = 10 ) -> list[Task]: """Get a list of tasks. Args: task_limit (int): The maximum number of tasks to return. Default is 10. Returns: list[Task]: A list of tasks. """ database: DatabaseABC = ctx.request_context.lifespan_context.db tasks = database.get_tasks(limit=task_limit) return [Task(**task.__dict__) for task in tasks]
• src/config/server.py:35-35 (registration)

  Invocation of create_tasks_tools which registers the tasks_list_tool (and other task tools) with the FastMCP server instance.
  create_tasks_tools(mcp)
• src/models/tasks.py:12-18 (schema)

  Pydantic BaseModel schema for Task objects returned by the tasks_list_tool.
  class Task(BaseModel): id: int = Field(default=None) title: str = Field(..., description="The title of the task") description: str = Field(default="", description="The description of the task") status: TaskStatus = TaskStatus.CREATED created_at: str = Field(default=None)
• src/models/tasks.py:6-10 (schema)

  Enum defining TaskStatus used in the Task model schema.
  class TaskStatus(IntEnum): CREATED = 0 IN_PROGRESS = 1 COMPLETED = 2
• src/config/server.py:10-10 (registration)

  Import of the create_tasks_tools function necessary for tool registration.
  from tools.tasks import create_tasks_tools