Taiga MCP Bridge

Instructions

Implementation Reference

• src/server.py:1144-1162 (handler)

  The handler function for the 'get_project_members' tool. It authenticates the session, calls the Taiga API to list project memberships, and returns the list of members.

  @mcp.tool("get_project_members", description="Lists members of a specific project.")
  def get_project_members(session_id: str, project_id: int) -> List[Dict[str, Any]]:
      """Retrieves the list of members for a project."""
      logger.info(
          f"Executing get_project_members for project {project_id}, session {session_id[:8]}...")
      taiga_client_wrapper = _get_authenticated_client(session_id) # Use wrapper variable name
      try:
          # Use pytaigaclient memberships resource list method
          members = taiga_client_wrapper.api.memberships.list(project_id=project_id)
          # return [m.to_dict() for m in members] # Remove .to_dict()
          return members # Return directly
      except TaigaException as e:
          logger.error(
              f"Taiga API error getting members for project {project_id}: {e}", exc_info=False)
          raise e
      except Exception as e:
          logger.error(
              f"Unexpected error getting members for project {project_id}: {e}", exc_info=True)
          raise RuntimeError(f"Server error getting project members: {e}")

• src/server.py:39-52 (helper)

  Helper function used by get_project_members (and other tools) to retrieve and validate the TaigaClientWrapper instance for the given session_id.

  def _get_authenticated_client(session_id: str) -> TaigaClientWrapper:
      """
      Retrieves the authenticated TaigaClientWrapper for a given session ID.
      Raises PermissionError if the session is invalid or not found.
      """
      client = active_sessions.get(session_id)
      # Also check if the client object itself exists and is authenticated
      if not client or not client.is_authenticated:
          logger.warning(f"Invalid or expired session ID provided: {session_id}")
          # Raise PermissionError - FastMCP will map this to an appropriate error response
          raise PermissionError(
              f"Invalid or expired session ID: '{session_id}'. Please login again.")
      logger.debug(f"Retrieved valid client for session ID: {session_id}")
      return client