Yandex Tracker MCP

Instructions

Implementation Reference

• mcp_tracker/mcp/tools.py:303-321 (handler)

  MCP tool handler and registration for 'issue_get_worklogs'. Supports multiple issue IDs, performs authorization checks, and delegates to the issues service to fetch worklogs.

  @mcp.tool(description="Get worklogs of a Yandex Tracker issue by its id")
  async def issue_get_worklogs(
      ctx: Context[Any, AppContext],
      issue_ids: IssueIDs,
  ) -> dict[str, list[Worklog]]:
      for issue_id in issue_ids:
          check_issue_id(settings, issue_id)
  
      result: dict[str, Any] = {}
      for issue_id in issue_ids:
          worklogs = (
              await ctx.request_context.lifespan_context.issues.issue_get_worklogs(
                  issue_id,
                  auth=get_yandex_auth(ctx),
              )
          )
          result[issue_id] = worklogs or []
  
      return result

• mcp_tracker/tracker/custom/client.py:350-359 (helper)

  Core implementation of issue_get_worklogs in the TrackerClient class, making HTTP GET request to Yandex Tracker API endpoint /v3/issues/{issue_id}/worklog and parsing the response.

  async def issue_get_worklogs(
      self, issue_id: str, *, auth: YandexAuth | None = None
  ) -> list[Worklog]:
      async with self._session.get(
          f"v3/issues/{issue_id}/worklog", headers=await self._build_headers(auth)
      ) as response:
          if response.status == 404:
              raise IssueNotFound(issue_id)
          response.raise_for_status()
          return WorklogList.model_validate_json(await response.read()).root

• mcp_tracker/tracker/caching/client.py:97-100 (helper)

  Caching wrapper for issue_get_worklogs that caches the result using aiocache.

  async def issue_get_worklogs(
      self, issue_id: str, *, auth: YandexAuth | None = None
  ) -> list[Worklog]:
      return await self._original.issue_get_worklogs(issue_id, auth=auth)

• mcp_tracker/tracker/proto/issues.py:32-34 (schema)

  Protocol (interface) definition for the issue_get_worklogs method used across clients.

  async def issue_get_worklogs(
      self, issue_id: str, *, auth: YandexAuth | None = None
  ) -> list[Worklog]: ...